EAS

上传ERP待开发票

POST

https://supplychain-dev.chinackts.com/qst/enterprise/{socialCreditCode}/output-invoice/push

上传ERP待开发票

请求参数

Path 参数

socialCreditCode

string

必需

Header 参数

nsrsbh

string

可选

默认值:

{{nsrsbh}}

Body 参数application/json

spbh

string

税盘编号/全电平台登录用户名

必需

金税盘(航信)在正面窗口中将XX-去除即为税盘编号
税控盘(百望)在背面S/N：后将XX-去除即为税盘编号
税务Ukey在背面的S/N号例：11-222222222222 222222222222即税盘编号
注：开具全电发票时，此字段需提供登录用户名

splx

string

税盘类型

必需

税盘类型：1-金税盘 2-税控盘 3-税务Ukey
注：全电发票可为空

kpxe

string

开票限额

必需

开票限额
注：全电发票可为空

orderNo

string

单据号

必需

内部单据号（订单号），默认一个订单号开具一张发票，超限额开票软件拆分

orderDate

string

日期

必需

单据号日期，可以是生成日期、请求日期，便于开票人员通过日期在开票软件界面筛选 YYYY-MM-DD HH:MM:SS

kplx

string

开票类型

必需

0 正数（蓝票）
1 负数（红票）
注：红票开具仅支持当前税盘已开发票的整票红冲不支持局部红冲.

fpzl

string

发票种类

必需

税控发票： 51-电普 2-普票 3-专票 4 电专
全电发票：01-专票 02-普票
全电纸质：01-专票 02-普票

qdbs

string

是否全电发票

可选

税控发票可填””
全电发票 (必填) 1
全电纸质 (必填) 2

gfmc

string

购方名称

必需

gfsh

string

购方税号

可选

可填””
注:税控专用发票、税控电子专票、数电纸质专票不可为空

gfdz

string

购方地址

可选

可填””
注:税控专用发票、税控电子专票、数电纸质专票不可为空

gfdh

string

购方电话

可选

可填””
注:税控专用发票、税控电子专票、数电纸质专票不可为空

gfkhh

string

购方开户行

可选

可填””
注:税控专用发票、税控电子专票、数电纸质专票不可为空

gfyhzh

string

购方银行账号

可选

可填””
注:税控专用发票、税控电子专票、数电纸质专票不可为空

xfmc

string

销方名称

必需

xfsh

string

销方税号

必需

xfdz

string

销方地址

必需

xfdh

string

销方电话

必需

xfkhh

string

销方开户行

必需

xfyhzh

string

销方银行账号

必需

hsjbz

string

含税价标志

必需

0价格不含税 1价格含税
注：不支持商品中同时使用含税不含税两种模式

hjje

string

合计金额

必需

此处为不含税金额注：固定小数点2位

hjse

string

合计税额

必需

注：固定小数点2位

jshj

string

价税合计

必需

注：固定小数点2位

qdbz

string

清单标志

必需

0无清单 1有清单
注：全电发票可为空

bz

string

备注

可选

非特殊票种基准长度:
金税盘专票：230字节
金税盘普票：230字节
金税盘电普票：230字节
税控盘专票：184字节
税控盘普票：138字节
税控盘电普票：130字节
税务 Ukey专票：184字节
税务Ukey普票：138字节
税务Ukey电普票：130字节
税务Ukey电专票：130 字节
正常发票备注不超过上述字节长度，如是差额征税或红字发票等，系统默认会填入备注信息，默认长度加用户入长度不超过上述长度：差额征税默认信息长度最少 18 字例：差额征税1.00。普票、电红字发默认备注最少普票、电红字发默认备注最少 46 字节例：对应正式发票代码012345678912 号码： 01234567 专票、电红字发默认备注最少专票、电红字发默认备注最少 50 字节例：开具红字增值税专用发票信息表编号 012345678901234 注： 1. 举例数据由系统自动生成，无需用户填入备注； 2. 如需填入回车换行（如需填入回车换行（ \r\n）,需输入转义字符“
”；

skr

string

收款人

可选

金税盘最大长度：20字节
税控盘最大长度：16字节

fhr

string

复核人

可选

金税盘最大长度：20字节
税控盘最大长度：16字节
税务Ukey最大长度：16字节

kpr

string

开票人

必需

金税盘最大长度：20字节
税控盘最大长度：16字节
税务Ukey最大长度：16字节

nwxbz

string

内外销标志

可选

可填”” 内销 0 外销 1

ssyf

string

所属月份

必需

格式：YYYYMM
注：红票时为蓝票开具月份。

yfpdm

string

原发票代码

可选

可填”” 原发票代码
注：红票必填

yfphm

string

原发票号码

可选

可填”” 原发票号码
注：红票必填

tdywlx

string

特定业务类型

可选

特定业务类型:
1建筑服务
2货物运输服务
3不动产销售
4不动产租赁
5保险机构代收车船税
6旅客运输服务
7医疗服务（门诊）
8医疗服务（住院）
9拖拉机和联合收割机
注：开具全电发票时有效，目前仅支持“2货物运输服务、4不动产租赁”

fpmx

array [object {17}]

发票明细节点

必需

xh

string

商品序号

必需

spsmmc

string

商品税目名称

必需

spmc

string

商品名称

必需

spbh

string

商品编号（税收分类编码）

必需

fphxz

string

发票行性质

必需

0表示正常行，1 表示折扣行，2 表示被折扣行3表示清单行
注：折扣行一定在被折扣行后面，顺序不得有误！折扣行负数发票数据内容填写折扣后的单价、金额及税额，无需填入折扣行

hsjbz

string

商品含税价标志

必需

0商品不含税 1商品含税
注:如不填入则默认按不含税计算

dj

string

单价

可选

金税盘专票、普票、电普票：小数点0~15位；税控盘专票、普票：整数不为0情况，总长度最大16位，小数点后最多14 整数为0情况，总长度最大17位，小数点后最多15 税控盘电普票：总长度最大16位，小数点后最多6 税务Ukey专票、普票、电专票：整数不为0情况，总长度最大16位，小数点后最多14 整数为0情况，总长度最大17位，小数点后最多15 税务Ukey电普票：总长度最大16位，小数点后最多6 注：单价和数量可以同时不填，如填入数量则必填单价

dw

string

单位

可选

可填””
金税盘最大长度：22字节
税控盘最大长度：32字节
税务Ukey最大长度：32字节

ggxh

string

规格型号

可选

可填””
金税盘最大长度：40字节

je

string

金额

必需

此处金额为不含税金额
注：固定小数点2位

se

string

税额

必需

注：固定小数点2位

slv

string

税率

必需

例：0.13
注：最多小数点3位

sl

string

数量

必需

金税盘专票、普票、电普票：小数点0~15位；税控盘专票、普票：整数不为0情况，总长度最大16位，小数点后最多14位整数为0情况，总长度最大17位，小数点后最多15位税控盘电普票：总长度最大16位，小数点后最多6位税务Ukey专票、普票、电专票：整数不为0情况，总长度最大16位，小数点后最多14位整数为0情况，总长度最大17位，小数点后最多15位税务Ukey电普票：总长度最大16位，小数点后最多6位注：单价和数量可以同时不填，如填入单价则必填数量

zke

string

折扣额

可选

yhzcbs

string

优惠政策标识

必需

0：不使用优惠政策
1：使用优惠政策，在税率标识（SLBS）填写相应税率标识

slbs

string

税率标识

必需

默认为非零税率暂只支持： 1：免税 2：不征收 3：普通零税率 4：非零税率
注：为1\2\4时优惠政策标识应为1 为3时优惠政策标识应为0

zzstsgl

string

增值税特殊管理

可选

可填”” 暂只支持: 按5%（3%）简易征收、免税、不征税、超税负3%（8% 12%）即征即退
注：优惠政策为 1 时该字段有效根据“3.10 税收编码下载”显示，目前为： 100%先征后退 50%先征后退不征税先征后退免税即征即退100% 即征即退30% 即征即退50% 即征即退70% 按3%简易征收按5%简易征收按5%简易征收减按1.5%计征按5%简易征收减按 3%计征稀土产品简易征收超税负12%即征即退超税负3%即征即退超税负8%即征即

tdywxx

array [object {13}]

特定业务信息

可选

bdcdz

string

【不动产信息】不动产地址

必需

例如：虹口区四川北路街道216弄

cqzsh

string

【不动产信息】产权证书/不动产权号

必需

若没有证书填写 ”无“

dw

string

【不动产信息】面积单位

必需

平方千米平方米公顷亩 h㎡ k㎡㎡

fullAddress

string

【不动产信息】不包含（市+区）的地址信息

必需

例如：四川北路街道216弄

kdsbz

string

【不动产信息】跨地（市）标志

必需

Y: 是 N: 否

zlqq

string

【不动产信息】租赁期起

必需

例如：2022-09-26

zlqz

string

【不动产信息】租赁期止

必需

例如：2022-10-26

hwysxxxh

string

【货物运输服务】货物运输信息序号

必需

ysgjzl

string

【货物运输服务】运输工具种类

必需

运输工具种类 1-铁路运输 2-公路运输 3-水路运输 4-航空运输 5-管道运输 6-其他运输工具

ysgjhp

string

【货物运输服务】运输工具号牌

必需

hwysqyd

string

【货物运输服务】货物起运地

必需

hwysddd

string

【货物运输服务】货物到达地

必需

yshwmc

string

【货物运输服务】运输货物名称

必需

示例

{
    "spbh": "string",
    "splx": "string",
    "kpxe": "string",
    "orderNo": "string",
    "orderDate": "string",
    "kplx": "string",
    "fpzl": "string",
    "qdbs": "string",
    "gfmc": "string",
    "gfsh": "string",
    "gfdz": "string",
    "gfdh": "string",
    "gfkhh": "string",
    "gfyhzh": "string",
    "xfmc": "string",
    "xfsh": "string",
    "xfdz": "string",
    "xfdh": "string",
    "xfkhh": "string",
    "xfyhzh": "string",
    "hsjbz": "string",
    "hjje": "string",
    "hjse": "string",
    "jshj": "string",
    "qdbz": "string",
    "bz": "string",
    "skr": "string",
    "fhr": "string",
    "kpr": "string",
    "nwxbz": "string",
    "ssyf": "string",
    "yfpdm": "string",
    "yfphm": "string",
    "tdywlx": "string",
    "fpmx": [
        {
            "xh": "string",
            "spsmmc": "string",
            "spmc": "string",
            "spbh": "string",
            "fphxz": "string",
            "hsjbz": "string",
            "dj": "string",
            "dw": "string",
            "ggxh": "string",
            "je": "string",
            "se": "string",
            "slv": "string",
            "sl": "string",
            "zke": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string"
        }
    ],
    "tdywxx": [
        {
            "bdcdz": "string",
            "cqzsh": "string",
            "dw": "string",
            "fullAddress": "string",
            "kdsbz": "string",
            "zlqq": "string",
            "zlqz": "string",
            "hwysxxxh": "string",
            "ysgjzl": "string",
            "ysgjhp": "string",
            "hwysqyd": "string",
            "hwysddd": "string",
            "yshwmc": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://supplychain-dev.chinackts.com/qst/enterprise//output-invoice/push' \
--header 'nsrsbh: {{nsrsbh}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spbh": "string",
    "splx": "string",
    "kpxe": "string",
    "orderNo": "string",
    "orderDate": "string",
    "kplx": "string",
    "fpzl": "string",
    "qdbs": "string",
    "gfmc": "string",
    "gfsh": "string",
    "gfdz": "string",
    "gfdh": "string",
    "gfkhh": "string",
    "gfyhzh": "string",
    "xfmc": "string",
    "xfsh": "string",
    "xfdz": "string",
    "xfdh": "string",
    "xfkhh": "string",
    "xfyhzh": "string",
    "hsjbz": "string",
    "hjje": "string",
    "hjse": "string",
    "jshj": "string",
    "qdbz": "string",
    "bz": "string",
    "skr": "string",
    "fhr": "string",
    "kpr": "string",
    "nwxbz": "string",
    "ssyf": "string",
    "yfpdm": "string",
    "yfphm": "string",
    "tdywlx": "string",
    "fpmx": [
        {
            "xh": "string",
            "spsmmc": "string",
            "spmc": "string",
            "spbh": "string",
            "fphxz": "string",
            "hsjbz": "string",
            "dj": "string",
            "dw": "string",
            "ggxh": "string",
            "je": "string",
            "se": "string",
            "slv": "string",
            "sl": "string",
            "zke": "string",
            "yhzcbs": "string",
            "slbs": "string",
            "zzstsgl": "string"
        }
    ],
    "tdywxx": [
        {
            "bdcdz": "string",
            "cqzsh": "string",
            "dw": "string",
            "fullAddress": "string",
            "kdsbz": "string",
            "zlqq": "string",
            "zlqz": "string",
            "hwysxxxh": "string",
            "ysgjzl": "string",
            "ysgjhp": "string",
            "hwysqyd": "string",
            "hwysddd": "string",
            "yshwmc": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

orderNo

string

单据号

必需

示例

{
    "orderNo": "string"
}

修改于 2025-04-28 05:53:33

查询退税率文库

接口关单开票