数电发票开具

方法名称：qdkp

接口及场景描述

接口描述：为企业提供数电发票开具功能

请求参数

Header 参数

url

string

百旺通地址

必需

默认值:

http://cs.bwmis.cn:55555/api/tax

privateKey

string

私钥

必需

默认值:

publicKey

string

公钥

必需

默认值:

userName

string

必需

默认值:

account

string

可选

默认值:

Body 参数application/json

method

string

必需

object

必需

string

备注

可选

备注信息

>= 0 字符<= 400 字符

fplxdm

string

发票类型代码

必需

发票类型代码
81：全电专
82：全电普

fpqqlsh

string

发票请求流水号

必需

32位可由字母，数字组成且不可重复

tdyslxdm

string

特定要素类型代码

可选

特定要素类型代码
"01"："成品油发票“,
"02"："稀土发票",
"03"："建筑服务发票",
"04"："货物运输服务发票",
"05"："不动产销售服务发票",
"06"："不动产经营租赁服务",
"07"："代收车船税",
"08"："通行费",
"09"："旅客运输服务发票",
"10"："医疗服务（住院）发票",
"11"："医疗服务（门诊）发票",
"12"："自产农产品销售发票",
"13"："拖拉机和联合收割机发票",
"14"："机动车",
"15"："二手车",
"16"："农产品收购发票",
"17"："光伏收购发票",
"18"："卷烟发票",
"19"："出口发票",
"20"："农产品"

fyxm

array [object {12}]

费用项目

必需

ghdwmc

string

购货单位名称

必需

<= 300 字符

ghdwsbh

string

购货单位识别号

可选

购货方为非自然人时此项必填

<= 26 字符

gmfdz

string

购买方地址

可选

<= 300 字符

gmflxdh

string

购买方联系电话

可选

<= 60 字符

gmfkhh

string

购买方开户行

可选

<= 120 字符

gmfyhzh

string

购买方银行账号

可选

<= 100 字符

fhr

string

复核人

可选

skr

string

收款人

可选

hjje

string

合计金额

必需

<= 16 字符

hjse

string

合计税额

必需

<= 16 字符

jshj

string

价税合计

必需

<= 16 字符

string

推送邮箱

可选

<= 40 字符

sjh

string

推送手机号

可选

<= 40 字符

hsbz

string

含税标志

必需

含税标志
0：不含税
1：含税

string

待开ID

可选

待开id（待开开票必传且只需要此字段，其他字段忽略）

djlsh

string

单据流水号

可选

单据流水号（单据开票必传）

zrrbs

string

自然人标识

可选

Y: 自然人
N: 非自然人（默认值）

pushType

string

推送类型

可选

当yx（推送邮箱）或 sjh （推送手机号）字段不为空时，此项必填
0：未勾选
1：推送手机号
2：推送邮箱
3：全部推送

kjly

string

开具理由

可选

开具理由：
条件必填：当小规模开具3%税率时，此字段为必传
04：前期已开具3%征收率发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具。
05：因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策。

sfzsgmfyhzh

string

是否展示购买方银行账号

可选

Y:是
N:不是

sfzsxsfyhzh

string

是否展示销售方银行账号

可选

Y:是 N:不是

示例

{
    "method": "qdkp",
    "object": {
        "bz": "备注测试",
        "fplxdm": "82",
        "fpqqlsh": "3345hhddjfjfjffjfjfwnnfijnffwww1",
        "tdyslxdm": "",
       
        "fyxm": [
            {
                "fphxz": "0",
                "spmc": "干脆面",
                "spbm": "1030299000000000000",
                "je": "10",
                "sl": "0.01",
                "se": "0.1",
                "ggxh": "",
                "dw": "",
                "dj": "10",
                "spsl": "1",
                "lslbs": "",
                "zzstsgl": ""
            }
        ],
        "ghdwmc": "测试人",
        "ghdwsbh": "",
        "gmfdz": "",
        "gmflxdh": "",
        "gmfkhh": "",
        "gmfyhzh": "",
        "fhr": "",
        "skr": "",
        "hjje": "10",
        "hjse": "0.1",
        "jshj": "10.1",
        "yx": "82254963@qq.com",
        "sjh": "",
        "hsbz": "0",
        "id": "",
        "djlsh": "",
        "zrrbs": "",
        "pushType": "2",
        "kjly": ""
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

⚪0数电发票开具

application/json

Body

code

integer

返回代码

必需

msg

string

返回消息

必需

data

object

返回数据

必需

fphm

string

发票号码

必需

kprq

string

开票日期

必需

格式：yyyy-MM-dd HH:mm:ss

zzfpdm

null

全电纸质发票代码

可选

zzfphm

null

全电纸质发票号码

可选

ewmUrl

string

二维码下载地址

必需

pdfUrl

string

pdf数据下载地址

必需

ofdUrl

string

ofd数据下载地址

必需

xmlUrl

string

xml数据下载地址

必需

kpr

string

开票人

可选

fpqqlsh

null

发票请求流水号

可选

示例

数电发票开具成功示例-多明细成功示例-多明细

{
    "code": 0,
    "msg": "成功",
    "data": {
        "fphm": "23122000000010699916",
        "kprq": "2023-09-21 10:49:25",
        "zzfpdm": null,
        "zzfphm": null,
        "ewmUrl": "https://dppt.tianjin.chinatax.gov.cn:8443/v/2_23122000000010699916_20230921104925100XQF9EF",
        "pdfUrl": "https://dppt.tianjin.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=PDF&Jym=F9EF&Fphm=23122000000010699916&Kprq=20230921104925&Czsj=1695264569182",
        "ofdUrl": "https://dppt.tianjin.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=OFD&Jym=F9EF&Fphm=23122000000010699916&Kprq=20230921104925&Czsj=1695264569182",
        "xmlUrl": "https://dppt.tianjin.chinatax.gov.cn:8443/kpfw/fpjfzz/v1/exportDzfpwjEwm?Wjgs=XML&Jym=F9EF&Fphm=23122000000010699916&Kprq=20230921104925&Czsj=1695264569182",
        "kpr": "lsh",
        "fpqqlsh": null
    }
}

⚪0失败-实人认证过期（-79）

🟢200失败-认证过期（-345）

🟢200异步获取

🟢200多明细开具

方法名称：qdkp#

接口及场景描述#

请求参数

示例代码

返回响应

方法名称：qdkp

接口及场景描述