单张发票开具（异步）

请求参数

Header 参数

nsrsbh

string

调用方税号

可选

默认值:

Body 参数application/json

requestId

string | null

业务请求流水号

必需

<= 100 字符

xsfnsrsbh

string | null

纳税人识别号

必需

<= 26 字符

xsfmc

string | null

(销售方)名称

必需

<= 300 字符

xsfdz

string | null

销售方地址

可选

<= 300 字符

xsfdh

string | null

销售方电话

可选

<= 60 字符

xsfkhh

string | null

销售方开户行

可选

<= 120 字符

xsfzh

string | null

销售方账号

可选

<= 100 字符

fppz

enum<string> | enum<null>

发票票种

必需

枚举值:

0102

正则匹配:

0[12]

tdys

string | null

特定要素

可选

正则匹配:

^$|0[1-9]|1[0-8]

qyDm

string | null

区域代码

可选

<= 20 字符

cezslxDm

string | null

差额征税类型代码

可选

正则匹配:

^$|0[12]

sgfplxDm

string | null

收购发票类型代码

可选

正则匹配:

^$|0[123]

ckywsyzcDm

string | null

可选

出口业务适用政策代码

正则匹配:

^$|0[123]

zzsjzjtDm

string | null

增值税即征即退代码

可选

正则匹配:

^$|0[1-9]|1[0-2]]

gmfzrrbz

string | null

购买方自然人标志

必需

正则匹配:

^$|[YN]

gmfnsrsbh

string | null

可选

（购买方）统一社会信用代码/纳税人识别号/身份证件号码

<= 26 字符

gmfmc

string | null

(购买方)名称

必需

<= 300 字符

gmfdz

string | null

购买方地址

可选

<= 300 字符

gmfdh

string | null

购买方电话

可选

<= 60 字符

gmfkhh

string | null

购买方开户行

可选

<= 120 字符

gmfzh

string | null

购买方账号

可选

<= 100 字符

gmfjbr

string | null

购买方经办人姓名

可选

<= 150 字符

jbrsfzjhm

string | null

可选

购买方经办人证件号码

<= 30 字符

gmfjbrlxdh

string | null

可选

购买方经办人联系电话

<= 60 字符

skyhmc

string | null

收款银行名称

可选

<= 120 字符

skyhzh

string | null

收款银行账号

可选

<= 100 字符

jsfs

string | null

结算方式

可选

正则匹配:

^$|0[1-5]|99

ysxwfsd

string | null

应税行为发生地

可选

<= 11 字符

kpr

string | null

开票人

必需

<= 300 字符

kprzjhm

string | null

开票人证件号码

可选

<= 30 字符

kprzjlx

string | null

开票人证件类型

可选

<= 4 字符

bz

string | null

备注

可选

<= 460 字符

sfzsxsfyhzhbq

string | null

可选

是否展示销售方银行账号标签

正则匹配:

^$|[YN]

sfzsgmfyhzhbq

string | null

可选

是否展示购买方银行账号标签

正则匹配:

^$|[YN]

skrxm

string | null

收款人姓名

可选

<= 150 字符

fhrxm

string | null

复核人姓名

可选

<= 75 字符

fpmxList

array [object {14}] | null

发票明细列表

必需

>= 1 items

sphfwssflhbbm

string | null

必需

商品和服务税收分类合并编码

<= 19 字符

spfwjc

string | null

商品服务简称

必需

<= 120 字符

spmc

string | null

必需

商品名称（项目名称中星号后的部分）

<= 400 字符

ggxh

string | null

规格型号

可选

<= 150 字符

dw

string | null

单位

可选

<= 300 字符

sl

string | null

数量

可选

<= 25 字符

dj

string | null

单价

可选

<= 25 字符

je

number | null

金额

可选

>= -1000000000000000000<= 1000000000000000000

se

number | null

税额

可选

>= -1000000000000000000<= 1000000000000000000

hsje

number | null

含税金额

可选

>= -1000000000000000000<= 1000000000000000000

slv

number | null

增值税税率/征收率

可选

>= -10000000000000000<= 10000000000000000

kce

number | null

扣除额

可选

>= -1000000000000000000<= 1000000000000000000

zkje

number | null

可选

折扣金额（不含税），是否单行折扣为Y时，可填

>= -1000000000000000000<= 1000000000000000000

yhzcbs

string | null

优惠政策标识

可选

正则匹配:

^$|0[1-9]|1[0-8]

fjysList

array[object (Fjys) {3}] | null

附加要素列表

可选

fjysmc

string | null

附加要素名称

可选

<= 200 字符

fjyslx

string | null

附加要素类型

可选

<= 200 字符

fjysz

string | null

附加要素值

可选

<= 200 字符

hzqrduuid

string | null

红字确认单uuid

可选

<= 32 字符

hzqrxxdbh

string | null

红字确认信息单编号

可选

<= 20 字符

dylzfphm

string | null

对应蓝字发票号码

可选

<= 20 字符

fpsx

string | null

必需

发票属性 0蓝票 1红票

正则匹配:

[01]

hjje

number | null

合计金额

必需

>= -1000000000000000000<= 1000000000000000000

hjse

number | null

合计税额

必需

>= -1000000000000000000<= 1000000000000000000

jshj

number | null

价税合计

必需

>= -1000000000000000000<= 1000000000000000000

ifSingleDiscoRow

string | null

可选

是否单行折扣（折扣金额（不含税））与商品行在同一行）

正则匹配:

^$|[YN]

示例

{
    "requestId": "string",
    "xsfnsrsbh": "string",
    "xsfmc": "string",
    "xsfdz": "string",
    "xsfdh": "string",
    "xsfkhh": "string",
    "xsfzh": "string",
    "fppz": "01",
    "tdys": "string",
    "qyDm": "string",
    "cezslxDm": "string",
    "sgfplxDm": "string",
    "ckywsyzcDm": "string",
    "zzsjzjtDm": "string",
    "gmfzrrbz": "string",
    "gmfnsrsbh": "string",
    "gmfmc": "string",
    "gmfdz": "string",
    "gmfdh": "string",
    "gmfkhh": "string",
    "gmfzh": "string",
    "gmfjbr": "string",
    "jbrsfzjhm": "string",
    "gmfjbrlxdh": "string",
    "skyhmc": "string",
    "skyhzh": "string",
    "jsfs": "string",
    "ysxwfsd": "string",
    "kpr": "string",
    "kprzjhm": "string",
    "kprzjlx": "stri",
    "bz": "string",
    "sfzsxsfyhzhbq": "string",
    "sfzsgmfyhzhbq": "string",
    "skrxm": "string",
    "fhrxm": "string",
    "fpmxList": [
        {
            "sphfwssflhbbm": "string",
            "spfwjc": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "sl": "string",
            "dj": "string",
            "je": -1000000000000000000,
            "se": -1000000000000000000,
            "hsje": -1000000000000000000,
            "slv": -10000000000000000,
            "kce": -1000000000000000000,
            "zkje": -1000000000000000000,
            "yhzcbs": "string"
        }
    ],
    "fjysList": [
        {
            "fjysmc": "string",
            "fjyslx": "string",
            "fjysz": "string"
        }
    ],
    "hzqrduuid": "string",
    "hzqrxxdbh": "string",
    "dylzfphm": "string",
    "fpsx": "string",
    "hjje": -1000000000000000000,
    "hjse": -1000000000000000000,
    "jshj": -1000000000000000000,
    "ifSingleDiscoRow": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://natural-system-dev.chinackts.com/ns-api/standard/drawup' \
--header 'nsrsbh: {{nsrsbh}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "xsfnsrsbh": "string",
    "xsfmc": "string",
    "xsfdz": "string",
    "xsfdh": "string",
    "xsfkhh": "string",
    "xsfzh": "string",
    "fppz": "01",
    "tdys": "string",
    "qyDm": "string",
    "cezslxDm": "string",
    "sgfplxDm": "string",
    "ckywsyzcDm": "string",
    "zzsjzjtDm": "string",
    "gmfzrrbz": "string",
    "gmfnsrsbh": "string",
    "gmfmc": "string",
    "gmfdz": "string",
    "gmfdh": "string",
    "gmfkhh": "string",
    "gmfzh": "string",
    "gmfjbr": "string",
    "jbrsfzjhm": "string",
    "gmfjbrlxdh": "string",
    "skyhmc": "string",
    "skyhzh": "string",
    "jsfs": "string",
    "ysxwfsd": "string",
    "kpr": "string",
    "kprzjhm": "string",
    "kprzjlx": "stri",
    "bz": "string",
    "sfzsxsfyhzhbq": "string",
    "sfzsgmfyhzhbq": "string",
    "skrxm": "string",
    "fhrxm": "string",
    "fpmxList": [
        {
            "sphfwssflhbbm": "string",
            "spfwjc": "string",
            "spmc": "string",
            "ggxh": "string",
            "dw": "string",
            "sl": "string",
            "dj": "string",
            "je": -1000000000000000000,
            "se": -1000000000000000000,
            "hsje": -1000000000000000000,
            "slv": -10000000000000000,
            "kce": -1000000000000000000,
            "zkje": -1000000000000000000,
            "yhzcbs": "string"
        }
    ],
    "fjysList": [
        {
            "fjysmc": "string",
            "fjyslx": "string",
            "fjysz": "string"
        }
    ],
    "hzqrduuid": "string",
    "hzqrxxdbh": "string",
    "dylzfphm": "string",
    "fpsx": "string",
    "hjje": -1000000000000000000,
    "hjse": -1000000000000000000,
    "jshj": -1000000000000000000,
    "ifSingleDiscoRow": "string"
}'

返回响应

🟢200成功

application/json

Body

fphm

string | null

发票号码

必需

<= 20 字符

lzfpbz

string | null

蓝字发票标志

必需

正则匹配:

[01]

ptbh

string | null

平台编号

必需

<= 20 字符

gmfzrrbz

string | null

购买方自然人标志

可选

正则匹配:

^$|[YN]

fppz

string | null

发票票种

必需

正则匹配:

0[12]

tdys

string | null

特定要素

可选

正则匹配:

^$|0[1-9]|1[0-8]

qyDm

string | null

区域代码

必需

<= 20 字符

cezslxDm

string | null

差额征税类型代码

可选

正则匹配:

^$|0[12]

sgfplxDm

string | null

收购发票类型代码

可选

正则匹配:

^$|0[123]

ckywsyzcDm

string | null

可选

出口业务适用政策代码

正则匹配:

^$|0[123]

zzsjzjtDm

string | null

增值税即征即退代码

可选

正则匹配:

^$|0[1-9]|1[0-2]

xsfnsrsbh

string | null

必需

（销售方）统一社会信用代码/纳税人识别号/身份证件号码

<= 26 字符

xsfmc

string | null

(销售方)名称

必需

<= 300 字符

xsfdz

string | null

销售方地址

可选

<= 300 字符

xsfdh

string | null

销售方电话

可选

<= 60 字符

xsfkhh

string | null

销售方开户行

可选

<= 120 字符

xsfzh

string | null

销售方账号

可选

<= 100 字符

gmfnsrsbh

string | null

可选

（购买方）统一社会信用代码/纳税人识别号/身份证件号码

<= 26 字符

gmfmc

string | null

（购买方）名称

必需

<= 300 字符

gmfdz

string | null

购买方地址

可选

<= 300 字符

gmfdh

string | null

购买方电话

可选

<= 60 字符

gmfkhh

string | null

购买方开户行

可选

<= 120 字符

gmfzh

string | null

购买方账号

可选

<= 100 字符

gmfjbr

string | null

购买方经办人姓名

可选

<= 150 字符

jbrsfzjhm

string | null

可选

购买方经办人证件号码

<= 30 字符

gmfjbrlxdh

string | null

可选

购买方经办人联系电话

<= 60 字符

hjje

number | null

合计金额

必需

>= -1000000000000000000<= 1000000000000000000

hjse

number | null

合计税额

必需

>= -1000000000000000000<= 1000000000000000000

jshj

number | null

价税合计

必需

>= -1000000000000000000<= 1000000000000000000

skyhmc

string | null

收款银行名称

可选

<= 120 字符

skyhzh

string | null

收款银行账号

可选

<= 100 字符

jsfs

string | null

结算方式

可选

正则匹配:

^$|0[1-5]|99

ysxwfsd

string | null

应税行为发生地

可选

<= 11 字符

kpr

string | null

开票人

必需

<= 300 字符

kprzjhm

string | null

开票人证件号码

可选

<= 30 字符

kprzjlx

string | null

开票人证件类型

可选

<= 4 字符

dylzfphm

string | null

对应蓝字发票号码

可选

<= 20 字符

hzqrxxdbh

string | null

红字确认信息单编号

可选

<= 20 字符

hzqrduuid

string | null

红字确认单uuid

可选

<= 32 字符

bz

string | null

备注

可选

<= 460 字符

ip

string | null

服务器地址

必需

<= 20 字符

macdz

string | null

mac地址

必需

<= 20 字符

cpuid

string | null

CPU序列号

可选

<= 20 字符

zbxlh

string | null

主板序列号

可选

<= 20 字符

kprq

string | null

开票日期

必需

正则匹配:

((([0-9]{3}[1-9]|[0-9]{2}[1-9][0-9]{1}|[0-9]{1}[1-9][0-9]{2}|[1-9][0-9]{3})-(((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01]))|((0[469]|11)-(0[1-9]|[12][0-9]|30))|(02-(0[1-9]|[1][0-9]|2[0-8]))))|((([0-9]{2})(0[48]|[2468][048]|[13579][26])|((0[48]|[2468][048]|[3579][26])00))-02-29))\s+([0-1]?[0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])

sfzsxsfyhzhbq

string | null

可选

是否展示销售方银行账号标签

正则匹配:

^$|[YN]

sfzsgmfyhzhbq

string | null

可选

是否展示购买方银行账号标签

正则匹配:

^$|[YN]

skrxm

string | null

收款人姓名

可选

<= 150 字符

fhrxm

string | null

复核人姓名

可选

<= 75 字符

fpmxList

array [object {14}] | null

发票明细列表

必需

>= 1 items

sphfwssflhbbm

string | null

必需

商品和服务税收分类合并编码

<= 19 字符

spfwjc

string | null

商品服务简称

必需

<= 120 字符

spmc

string | null

必需

商品名称（项目名称中星号后的部分）

<= 400 字符

ggxh

string | null

规格型号

可选

<= 150 字符

dw

string | null

单位

可选

<= 300 字符

sl

string | null

数量

可选

<= 25 字符

dj

string | null

单价

可选

<= 25 字符

je

number | null

金额

可选

>= -1000000000000000000<= 1000000000000000000

se

number | null

税额

可选

>= -1000000000000000000<= 1000000000000000000

hsje

number | null

含税金额

可选

>= -1000000000000000000<= 1000000000000000000

slv

number | null

增值税税率/征收率

可选

>= -10000000000000000<= 10000000000000000

kce

number | null

扣除额

可选

>= -1000000000000000000<= 1000000000000000000

zkje

number | null

可选

折扣金额（不含税），是否单行折扣为Y时，可填

>= -1000000000000000000<= 1000000000000000000

yhzcbs

string | null

优惠政策标识

可选

正则匹配:

^$|0[1-9]|1[0-8]

fjysList

array[object (Fjys) {3}] | null

附加要素列表

可选

fjysmc

string | null

附加要素名称

可选

<= 200 字符

fjyslx

string | null

附加要素类型

可选

<= 200 字符

fjysz

string | null

附加要素值

可选

<= 200 字符

id

integer | null

可选

requestId

string | null

可选

requestIdSortNo

integer | null

可选

fpState

string | null

可选

fpStateMsg

string | null

可选

createTime

string | null

可选

updateTime

string | null

可选

fileFormat

integer | null

可选

sllsh

string | null

可选

extCol1

string | null

可选

extCol2

string | null

可选

extCol3

string | null

可选

extCol4

string | null

可选

extCol5

string | null

可选

sykhcHjje

number | null

可选

sykhcHjse

number | null

可选

sykhcJshj

number | null

可选

示例

{
  "fphm": "",
  "lzfpbz": "",
  "ptbh": "",
  "gmfzrrbz": "",
  "fppz": "",
  "tdys": "",
  "qyDm": "",
  "cezslxDm": "",
  "sgfplxDm": "",
  "ckywsyzcDm": "",
  "zzsjzjtDm": "",
  "xsfnsrsbh": "",
  "xsfmc": "",
  "xsfdz": "",
  "xsfdh": "",
  "xsfkhh": "",
  "xsfzh": "",
  "gmfnsrsbh": "",
  "gmfmc": "",
  "gmfdz": "",
  "gmfdh": "",
  "gmfkhh": "",
  "gmfzh": "",
  "gmfjbr": "",
  "jbrsfzjhm": "",
  "gmfjbrlxdh": "",
  "hjje": 0.0,
  "hjse": 0.0,
  "jshj": 0.0,
  "skyhmc": "",
  "skyhzh": "",
  "jsfs": "",
  "ysxwfsd": "",
  "kpr": "",
  "kprzjhm": "",
  "kprzjlx": "",
  "dylzfphm": "",
  "hzqrxxdbh": "",
  "hzqrduuid": "",
  "bz": "",
  "ip": "",
  "macdz": "",
  "cpuid": "",
  "zbxlh": "",
  "kprq": "",
  "sfzsxsfyhzhbq": "",
  "sfzsgmfyhzhbq": "",
  "skrxm": "",
  "fhrxm": "",
  "fpmxList": [
    {
      "mxxh": 0,
      "dylzfpmxxh": 0,
      "hwhyslwfwmc": "",
      "spfwjc": "",
      "xmmc": "",
      "ggxh": "",
      "dw": "",
      "sl": "",
      "dj": "",
      "je": 0.0,
      "slv": 0.0,
      "se": 0.0,
      "hsje": 0.0,
      "kce": 0.0,
      "sphfwssflhbbm": "",
      "fphxz": "",
      "yhzcbs": ""
    }
  ],
  "fjysList": [
    {
      "fjysmc": "",
      "fjyslx": "",
      "fjysz": ""
    }
  ],
  "id": 0,
  "requestId": "",
  "requestIdSortNo": 0,
  "fpState": "",
  "fpStateMsg": "",
  "createTime": "",
  "updateTime": "",
  "fileFormat": 0,
  "sllsh": "",
  "extCol1": "",
  "extCol2": "",
  "extCol3": "",
  "extCol4": "",
  "extCol5": "",
  "sykhcHjje": 0.0,
  "sykhcHjse": 0.0,
  "sykhcJshj": 0.0
}