发票开具（蓝票） - 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

可选

bz

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

明细信息

可选

xh

string | null

序号

可选

fphxz

string | null

发票行性质

可选

spmc

string | null

商品名称

可选

ggxh

string | null

规格型号

可选

dw

string | null

单位

可选

spsl

string | null

数量

可选

dj

string | null

单价

可选

je

string | null

金额

可选

sl

string | null

税率

可选

se

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

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://banas.ccitcn.com/api/sale/buildInvoice' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢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"
}