发票开具（蓝票） - Banas 开放平台

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

uid

string

唯一编码

必需

>= 16 字符<= 36 字符

nsrsbh

string

税号

必需

>= 1 字符

dlsfsjh

string

登录身份手机号

必需

>= 1 字符

fplxdm

string | null

可选

kplx

string | null

可选

tspz

string | null

可选

hsslbs

string | null

可选

xhdwdzdh

string | null

可选

xhdwyhzh

string | null

可选

ghdwsbh

string | null

可选

ghdwmc

string | null

北京李四有限公司

可选

ghdwdzdh

string | null

购货单位地址电话

可选

ghdwyhzh

string | null

购货单位银行账号

可选

sfzsgmfyhzh

string | null

可选

是否展示购买方银行账号

xhdwdz

string | null

销方地址

可选

xhdwdh

string | null

销方联系电话

可选

xhdwyh

string | null

销方开户行

可选

xhdwzh

string | null

销方银行账号

可选

sfzsxsfyhzh

string | null

可选

是否展示销售方银行账号

ghdwdz

string | null

购买方地址

可选

ghdwdh

string | null

购买方联系电话

可选

ghdwyh

string | null

购买方开户行

可选

ghdwzh

string | null

购买方银行账号

可选

gmfZrrbs

string | null

购买方自然人标识

可选

gfxxconfirm

string | null

可选

局端对购方信息会有校验，信息有误时会提示当前未查询到购买方纳税人信息，请确认是否继续开具,可传 0 强制开具

zhsl

string | null

可选

sslkjly

string | null

可选

小规模、转登记纳税人 2021 年 12 月 31 日前 3%税率开具发票理由

isMutiRate

string | null

可选

hjje

string | null

可选

hjse

string | null

可选

jshj

string | null

可选

qdbz

string | null

可选

string | null

备注

可选

ncpsgzjlx

string | null

农产品收购证件类型

可选

skr

string | null

收款人

可选

fhr

string | null

复核人

可选

kpr

string | null

开票人

可选

tzdbh

string | null

通知单编号

可选

yqdfphm

string | null

全电发票号码

可选

xxbid

string | null

信息表 id

可选

yfpdm

string | null

可选

yfphm

string | null

可选

yfplx

string | null

可选

ykprq

string | null

可选

chyydm

string | null

可选

zyspmc

string | null

大白菜

可选

gmfDzyx

string | null

购买方电子邮箱

可选

gmfSjhm

string | null

购买方手机号码

可选

gmfOpenid

string | null

购买方微信 id

可选

tdyslxdm

string | null

可选

特定要素类型代码（01：成品油发票 02：稀土发票: 03建筑服务发票...）

invoiceItemList

array[object (SaleInvoiceItem) {18}] | null

明细信息

可选

string | null

序号

可选

fphxz

string | null

发票行性质

可选

spmc

string | null

商品名称

可选

ggxh

string | null

规格型号

可选

string | null

单位

可选

spsl

string | null

数量

可选

string | null

单价

可选

string | null

金额

可选

string | null

税率

可选

string | null

税额

可选

kcje

string | null

扣除金额

可选

hsbz

string | null

可选

含税标识 0 不含税 1 含税

spbm

string | null

税收分类编码

可选

yhzcbs

string | null

可选

优惠政策标识 0 是不使用，1 是使用

slbs

string | null

税率标识

可选

zzstsgl

string | null

可选

增值税特殊管理（优惠政策名称）

tdzsfsdm

string | null

可选

特定征税方式代码 01:不征税 02:零税率 03:减按 04:免税 05:简易征税

zzstsgldm

string | null

可选

税收优惠政策类型代码 01：简易征收 02：稀土产品 03：免税 04：不征税 05：先征后退

示例

{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "fplxdm": "string",
    "kplx": "string",
    "tspz": "string",
    "hsslbs": "string",
    "xhdwdzdh": "string",
    "xhdwyhzh": "string",
    "ghdwsbh": "string",
    "ghdwmc": "string",
    "ghdwdzdh": "string",
    "ghdwyhzh": "string",
    "sfzsgmfyhzh": "string",
    "xhdwdz": "string",
    "xhdwdh": "string",
    "xhdwyh": "string",
    "xhdwzh": "string",
    "sfzsxsfyhzh": "string",
    "ghdwdz": "string",
    "ghdwdh": "string",
    "ghdwyh": "string",
    "ghdwzh": "string",
    "gmfZrrbs": "string",
    "gfxxconfirm": "string",
    "zhsl": "string",
    "sslkjly": "string",
    "isMutiRate": "string",
    "hjje": "string",
    "hjse": "string",
    "jshj": "string",
    "qdbz": "string",
    "bz": "string",
    "ncpsgzjlx": "string",
    "skr": "string",
    "fhr": "string",
    "kpr": "string",
    "tzdbh": "string",
    "yqdfphm": "string",
    "xxbid": "string",
    "yfpdm": "string",
    "yfphm": "string",
    "yfplx": "string",
    "ykprq": "string",
    "chyydm": "string",
    "zyspmc": "string",
    "gmfDzyx": "string",
    "gmfSjhm": "string",
    "gmfOpenid": "string",
    "tdyslxdm": "string",
    "invoiceItemList": [
        {
            "xh": "string",
            "fphxz": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "spsl": "string",
            "dj": "string",
            "je": "string",
            "sl": "string",
            "se": "string",
            "kcje": "string",
            "hsbz": "string",
            "spbm": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string",
            "tdzsfsdm": "string",
            "zzstsgldm": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://banas.ccitcn.com/api/sale/buildInvoice' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "fplxdm": "string",
    "kplx": "string",
    "tspz": "string",
    "hsslbs": "string",
    "xhdwdzdh": "string",
    "xhdwyhzh": "string",
    "ghdwsbh": "string",
    "ghdwmc": "string",
    "ghdwdzdh": "string",
    "ghdwyhzh": "string",
    "sfzsgmfyhzh": "string",
    "xhdwdz": "string",
    "xhdwdh": "string",
    "xhdwyh": "string",
    "xhdwzh": "string",
    "sfzsxsfyhzh": "string",
    "ghdwdz": "string",
    "ghdwdh": "string",
    "ghdwyh": "string",
    "ghdwzh": "string",
    "gmfZrrbs": "string",
    "gfxxconfirm": "string",
    "zhsl": "string",
    "sslkjly": "string",
    "isMutiRate": "string",
    "hjje": "string",
    "hjse": "string",
    "jshj": "string",
    "qdbz": "string",
    "bz": "string",
    "ncpsgzjlx": "string",
    "skr": "string",
    "fhr": "string",
    "kpr": "string",
    "tzdbh": "string",
    "yqdfphm": "string",
    "xxbid": "string",
    "yfpdm": "string",
    "yfphm": "string",
    "yfplx": "string",
    "ykprq": "string",
    "chyydm": "string",
    "zyspmc": "string",
    "gmfDzyx": "string",
    "gmfSjhm": "string",
    "gmfOpenid": "string",
    "tdyslxdm": "string",
    "invoiceItemList": [
        {
            "xh": "string",
            "fphxz": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "spsl": "string",
            "dj": "string",
            "je": "string",
            "sl": "string",
            "se": "string",
            "kcje": "string",
            "hsbz": "string",
            "spbm": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string",
            "tdzsfsdm": "string",
            "zzstsgldm": "string"
        }
    ]
}'

返回响应

🟢200OK

application/json

Body

Banas 返回结果

result

object (SaleInvoiceResponse)

可选

fpdm

string | null

发票代码

可选

fphm

string | null

发票号码

可选

fplxdm

string | null

发票类型代码

可选

qdfphm

string | null

全电发票号码

可选

kprq

string | null

开票日期

可选

ewmUrl

string | null

可选

pdfUrl

string | null

PDF 链接

可选

ofdUrl

string | null

OFD 链接

可选

xmlUrl

string | null

XML 链接

可选

status

integer <int32>

可选

状态码 200 成功

errorMessage

string | null

异常信息

可选

示例

{
    "result": {
        "fpdm": "string",
        "fphm": "string",
        "fplxdm": "string",
        "qdfphm": "string",
        "kprq": "string",
        "ewmUrl": "string",
        "pdfUrl": "string",
        "ofdUrl": "string",
        "xmlUrl": "string"
    },
    "status": 0,
    "errorMessage": "string"
}