扫码开票-普通发票 - 数电前置API

请求参数

Header 参数

actionCode

string

可选

示例值:

XXSMKPSQ

taxnum

string

税号

可选

interfaceCode

string

授权码

可选

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

fpzt

object

发票主体信息

必需

kplsh

string

开票流水号

必需

fppz

string

发票种类

必需

01全电专票；02全电普票

tdyw

enum<string>

特定业务类型

必需

枚举值:

000102

xsfnsrsbh

string

销方税号

必需

kpr

string

开票人

必需

bzxx

string

备注

可选

bzzt

string

备注标志

必需

1: 发票备注+小票备注
2: 小票备注

jfsj

string

交付手机号

可选

jfyx

string

交付邮箱

可选

xym

string

开票密码

可选

kpsl

string

开票数量

必需

大于1会生成多个一样的开票数据

hddz

string

回调地址

可选

开票后发票数据回传地址

yhid

string

用户ID

可选

用于系统内部，如需找客服获取

bmid

string

部门ID

可选

用于系统内部，如需找客服获取

fpmxList

array [object {14}]

发票明细信息

必需

hh

integer

行号

必需

从1开始递增，1、2、3、4、5

spmc

string

商品名称

必需

zklx

string

折扣类型

必需

zkje-折扣金额；zkl-折扣率；amount-正常行

zkje

string

折扣金额

可选

zklx为zkje时，该值不能为空，最多保留两位小数

zkl

string

折扣率

可选

zklx为zkl时，该值不能为空，如13%填13

ggxh

string

规格型号

可选

dw

string

单位

可选

business_type:02必填

sl

string

数量

可选

business_type:02必填，最多保留13位小数

hsbz

string

含税标志

必需

0-不含税；1-含税

hsdj

string

含税单价

可选

business_type:02必填，最多保留13位小数

slv

string

税率

必需

小数，如0.06

jshj

string

价税合计

必需

最多保留两位小数

ssflbm

string

税收分类编码

可选

fphxz

string

发票行性质

必需

0-普通行；1-折扣行；2-被折扣行

示例

{
    "fpzt": {
        "kplsh": "20250212001",
        "fppz": "01",
        "tdyw": "00",
        "xsfnsrsbh": "",
        "kpr": "张三",
        "bzzt": "1",
        "kpsl": "1"
    },
    "fpmxList": [
        {
            "hh": 1,
            "spmc": "房屋销售",
            "zklx": "amount",
            "hsbz": "1",
            "slv": "0.05",
            "jshj": "2999",
            "ssflbm": "1010101020000000000",
            "fphxz": "0"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://120.48.195.50:5000/EInvoice-Test/Api' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fpzt": {
        "kplsh": "20250212001",
        "fppz": "01",
        "tdyw": "00",
        "xsfnsrsbh": "",
        "kpr": "张三",
        "bzzt": "1",
        "kpsl": "1"
    },
    "fpmxList": [
        {
            "hh": 1,
            "spmc": "房屋销售",
            "zklx": "amount",
            "hsbz": "1",
            "slv": "0.05",
            "jshj": "2999",
            "ssflbm": "1010101020000000000",
            "fphxz": "0"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

状态码

必需

0000-申请扫码开票成功；9999-申请扫码开票失败

mess

string

状态描述

必需

data

object

必需

xmddh

array[string]

扫码订单ID

必需

xmlj

array[string]

扫码开票H5端链接

必需

示例

{
    "code": "0000",
    "mess": "扫码开票信息申请成功！",
    "data": {
        "xmddh": [
            "951293431624800112"
        ],
        "xmlj": [
            "http://10.10.10.25:9876/EInvoice-H5/?t=951293431624800112"
        ]
    }
}