数电通开放平台

数电发票 API 接口文档

百望云平台开票配置、接口参数、请求示例与返回示例。

开票配置

一、数电发票开票配置

数电发票开具的前提是需添加电局账号 → 电局账号登录 → 刷脸认证，完成以上步骤可通过以下两种方式：

💡 提示：推荐使用方式一（通过“获取数电账号管理url”接口配置），可以更便捷地完成账号添加、登录和认证流程。

商户开票前期配置

2.1 获取百望平台账号密码

商户开通成功后，会发送百望云登录账号和密码，请查收邮件获取到账号密码（如果商户以前注册过百望则不会发送账密邮件）。邮箱通知如下图所示：

📧

百望云账号密码邮件通知示例

发件人：系统服务 <yun2@vip.baiwang.com>

管理员账号：admin_nr | 租户ID：xxxx

原附件图片需要授权访问，当前展示操作说明

2.2 维护数电账号信息

后台地址：百望云登录，账号密码会在开户时发送到上传的邮箱里，请注意查收。

路径：销项 → 数电连接设置 → web连接器设置

初始进入数电连接，会进行配置，连接通道请选择 WEB连接器通道

🔌

选择连接器通道 - WEB连接器通道

原附件图片需要授权访问，当前展示操作说明

账号密码请输入开票人员登录电子税务局时所用的账号、密码

➕

添加电局账号 - 填写配置信息

原附件图片需要授权访问，当前展示操作说明

添加完电局账号之后，点击编辑按钮

✏️

配置完成后可在列表操作数电账号的登录、认证

原附件图片需要授权访问，当前展示操作说明

2.2.3 注意事项

		        【用户名/实名手机】建议填开票人员在电子税务局登记的手机号，不要填企业的统一信用代码；
【用户密码】填写电子税务的登录密码；

		                如果商户有多个开票员轮流值班，需要添加多个开票员，怎么支持此类场景？
		                如果使用我司数电账号管理url接口管理电局账号的，则将多个开票员账号统一添加，将值班的开票员设置成默认开票员即可，我们会用默认开票员请求上游。
如果使用百望云后台管理电局账号的，将多个开票员账号统一添加，然后谁值班将谁设置成默认开票员，设置路径：销项 → 数电连接设置 → 找到对应的开票员点编辑 → 默认开票员开关打开 → 保存。

⚙️

默认开票员设置界面

账号应用：开票/用票 | 默认开票员：手机号

原附件图片需要授权访问，当前展示操作说明

2.2.4 如何提升电局账号登录、认证时效

1. 时效说明
电局账号登录、认证成功是开具数电票的前提。百望给出的口径是登录一次一般续活12h左右，实人认证的时长则跟商户主体资质有关。

2. 建议
对于开票时效要求较高的客户，建议每天上下班检查下登录、认证状态；

3. 如何提升登录时效

电局账号登录之后请勿在其他平台再次登录，否则将会被顶掉影响开票。税局只允许一个账号同时在一个地方登录，所以请注意

4. 如何提升认证时效

实人认证的时长跟商户主体资质有关，可以在电子税务局-蓝字发票开具中找到下图功能拉到最大，对实人认证续活有帮助（注意：只有企业法人或者财务负责人角色能设置）

👤

扫脸认证时长设置

可设置：0小时、12小时、24小时、36小时、48小时

"0小时"代表逐票扫脸，即每次开票都需要扫脸认证

原附件图片需要授权访问，当前展示操作说明

接口文档

整理说明：本页面完整收录了14个发票相关接口的全部内容，包括请求参数、返回参数、嵌套子参数（可折叠）、请求示例和返回示例。

操作提示：点击带有 ▶ 子参数名称样式的按钮即可展开查看详细字段。

1. 开票接口

POST/merchant/elecInvoice/openInvoice

📌 接口说明

合作伙伴调用此接口帮助已开通发票功能的商户开票。

1、直接开票模式下，调用开票接口如果遇到超时（返回的bizCode=70184 、70186）、电局账号登录失效（返回的bizCode=70031）、实人认证失效（返回的bizCode=70045）时开票状态status=02开票中，开票中我司会自动调用上游接口获取终态，如果传了回调地址，获取终态后会回调开票结果；如果返回的开票状态status=03开票成功的，则不会再回调开票结果。

2、链接开票模式下，返回的开票状态status=00待申请，我司获取终态后均会回调开票结果；

📋 请求参数 - 主参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	15	M	商户发票商编
invoiceOrderNo	String	32	M	商户开票订单号，最大32位
invoiceWay	String	2	M	开票方式 00 直接开票 01 链接开票 1、直接开票指的是客户已知悉消费者的购方信息，将商品、购方等开票必要信息一并上送，请求开具发票； 2、链接开票指的是获取一个开票链接，然后发给消费者，消费者打开自行填写购方信息，提交后再开具发票
linkInvoiceCode	String	3	O	开票链接指定票种生成开票链接时可支持设定可开票的类型。仅链接开票模式下有效枚举： 01 数电发票（增值税专用发票） 02 数电发票（普通发票）注意：需传商户目前支持开具的票种
phoneDisplayflag	String	2	O	开票链接是否展示手机号填写栏 00展示 01不展示不传，默认00，仅链接开票模式下有效，如使用我司开票链接且不想产生短信资费的可以使用此字段控制
linkExpiryDate	String	-	O	开票链接有效期当invoiceWay=01时可设置开票链接有效期，设置区间1~999天，如果不传默认最大有效期999天
invoiceAmt	String	9	M	开票金额，格式：#######.## 需同商品明细合计金额一致
tradeFinishTime	String	32	O	开票时间，传入当前时间即可如果不传也会默认当前时间，格式：yyyy-MM-dd HH:mm:ss
taxUserName	String	11	O	电局账号适用于多开票员场景。传当前处于登录、认证成功的电局账号以保证不会因登录、认证失效而导致开票失败，如不传，百望会根据一定规则自动取值。
drawer	String	-	O	开票员姓名作用同taxUserName，如果两个都传了以taxUserName为准
callBack	String	256	O	回调地址
invoiceRemark	String	200	O	发票备注
displayBuyer	String	-	O	购方开户行、银行账号是否显示在备注 00显示 01不显示此参数的作用是本信息不占用备注字数
displayBuyerAddTel	String	-	O	购方地址、联系电话是否显示在备注 00显示 01不显示此参数的作用是本信息不占用备注字数
displaySeller	String	-	O	销方开户行、银行账号是否显示在备注 00显示 01不显示此参数的作用是本信息不占用备注字数
displaySellerAddTel	String	-	O	销方地址、联系电话是否显示在备注 00显示 01不显示此参数的作用是本信息不占用备注字数
invoiceSpecialMark	String	-	O	特殊票种标记 00：普通发票 01：不动产租赁服务发票（数电） 03：建筑服务发票（数电） 09：成品油（数电） 10：旅客运输发票（数电）不传默认00 1、特殊票种为01/03/09/10时只允许传一个商品明细，否则上游会拦截； 2、附件税编如开具数电发票则必传特殊票种《数电发票特定业务税编》，譬如常见的车辆停放服务，请务必关注。
invoiceSpecialInfoList	List	-	C	数电特定业务信息特殊票种为01/03时必传
goodsInfoList	List	-	M	商品信息list，可多传不唯一
buyerInfoListList	List	-	O	购方信息list，唯一不可多传选择链接开票时，此项传了无效

▶ goodsInfoList（商品信息list，可多传不唯一）- 请求

参数名	数据类型	长度限制	必填	说明
goodsName	String	64	M	商品名称会展示在发票票面的【项目名称】中如：* 住宿服务 *住宿费，前面的住宿服务是根据税编带出不可修改，后面的住宿费取得商品名称
goodsId	String	32	M	外部商品id 由服务商自定义
goodsPrice	String	17	C	商品单价特殊票种为09时，必传
goodsNum	String	17	C	商品数量特殊票种为01/09时必传
subtotalAmount	String	9	M	商品金额，最多支持2位小数如果单价、数量、金额都传了需要保证单价*数量=金额
goodsUnit	String	10	C	商品单位特殊票种为09成品油（数电）时，商品单位必填，且只能填写吨或升
goodsSpecification	String	40	O	商品规格
goodsCode	String	32	M	标准税收编码《税收编码表》，请使用这个表里的末级节点税编，即："是否汇总项"为"否"的
goodsTaxRate	String	-	M	税率，枚举： 00 免税 01 0% 02 1% 03 3% 05 5% 06 6% 09 9% 13 13% 需注意，选择5%时需选择使用优惠政策，且优惠政策传16：按5%简易征收
specialGoodsTaxRate	String	-	O	专票税率，枚举同goodsTaxRate一致本参数针对同一商品专普票税率不一致的场景。如果无需区分专普票税率，则无需传此参数。如需区分，则此参数将作为专票税率，goodsTaxRate为普票税率。
freeTaxMark	String	-	O	零税率标识，枚举： 01 出口免税和其他免税优惠政策 02 不征增值税 03 普通零税率请注意：当税率选择0%时，零税率标识请传03
preferentialMark	String	-	O	是否使用优惠政策，枚举： 00 不使用 01 使用
vatSpecialManagement	String	-	C	优惠政策类型，使用优惠政策时此项必传，枚举： 00 不征税 01 免税 02 先征后退 03 100%先征后退 04 50%先征后退 05 简易征收 06 即征即退30% 07 即征即退50% 08 即征即退70% 09 即征即退100% 10 超税负3%即征即退 11 超税负6%即征即退 12 超税负8%即征即退 13 超税负12%即征即退 14 稀土产品 15 按5%简易征收减按1.5%计征 16 按5%简易征收 17 按3%简易征收

▶ buyerInfoListList（购方信息list，唯一不可多传）- 请求

参数名	数据类型	长度限制	必填	说明
invoiceTypeCode	String	3	M	开票类型，枚举： 01 数电发票（增值税专用发票） 02 数电发票（普通发票）
email	String	30	O	发票接收邮箱
receivePhone	String	11	O	发票接收手机邮箱和手机号需必传其一，短信会产生资费，请酌情使用
buyerName	String	150	M	购方名称
buyerTaxNo	String	40	C	购方税号，企业抬头必传
buyerPhone	String	18	C	购方电话 displayBuyerAddTel=00时必传
buyerAddress	String	200	C	购方地址 displayBuyerAddTel=00时必传
buyerBank	String	256	C	购方开户行 displayBuyer=00时必传
buyerBankAccount	String	128	C	购方开户行账号 displayBuyer=00时必传

▶ invoiceSpecialInfoList（数电特定业务信息）- 请求

特殊票种为01/03时必传

建筑服务特定要素（invoiceSpecialMark=03时必传）

参数名	数据类型	长度限制	必填	说明
buildingLocalAddress	String	120	C	建筑服务特定要素-建筑服务发生地，按照省、市、区/县三级传值，以&符间隔，举例："河北省&石家庄市&正定县" invoiceSpecialMark=03时必传
buildingDetailAddress	String	120	C	建筑服务特定要素-建筑服务详细地址，举例"北京市海淀区清华东路 17 号"(建筑服务发生地和详细地址之和为120) invoiceSpecialMark=03时必传
buildingName	String	80	C	建筑服务特定要素-建筑项目名称 invoiceSpecialMark=03时必传
buildingLandTaxNo	String	16	O	建筑服务特定要素-土地增值税项目编号
buildingCrossSign	String	-	C	建筑服务特定要素-跨地（市）标志；枚举：Y：是；N：否 invoiceSpecialMark=03时必传
kqysssxbgglBm	String	50	C	建筑服务特定要素-跨区域涉税事项报验管理编号 invoiceSpecialMark=03且跨地（市）标志为Y时，必传

不动产租赁特定要素（invoiceSpecialMark=01时必传）

参数名	数据类型	长度限制	必填	说明
leasePropertyNo	String	64	C	不动产租赁-房屋产权证书/不动产权证号码，如果没有可以填"无" invoiceSpecialMark=01时必传
leaseAddress	String	120	C	不动产租赁-不动产地址，按照省、市、区/县三级传值，以&符间隔，举例"河北省&石家庄市&正定县" invoiceSpecialMark=01时必传
leaseDetailAddress	String	120	C	不动产租赁-详细地址，举例"北京市海淀区清华东路 17号"（不动产地址和详细地址之和为 120） invoiceSpecialMark=01时必传
leaseCrossSign	String	-	C	不动产租赁-跨地（市）标志，枚举： Y：是；N：否 invoiceSpecialMark=01时必传指的是企业（销方）注册地和不动产地址是否在一个地（市）
propertyAreaUnit	String	16	C	不动产租赁-面积单位 invoiceSpecialMark=01时必传面积单位可使用：平方千米、平方米、公顷、亩、㎡、k㎡、h㎡
leaseHoldDateStart	String	20	C	不动产租赁-租赁期起； invoiceSpecialMark=01时必传指的是购方的租赁周期格式传yyyy-MM-dd（如果传年月日时分，百望会自动截取），税编为3040502020200000000时，格式需为yyyy-MM-dd HH:mm（如果传年月日，百望会自动将时分补为00:00）
leaseHoldDateEnd	String	20	C	不动产租赁-租赁期止； invoiceSpecialMark=01时必传格式传yyyy-MM-dd（如果传年月日时分，百望会自动截取），税编为3040502020200000000时，格式需为yyyy-MM-dd HH:mm（如果传年月日，百望会自动将时分补为00:00）
cph	String	15	O	车牌号仅税编为3040502020200000000时可填写，其他税编填写无效

旅客运输特定要素（invoiceSpecialMark=10时）

参数名	数据类型	长度限制	必填	说明
carriageName	String	20	C	旅客运输-出行人；当invoiceSpecialMark=10时，旅客运输信息要么都不传，要么按要求传入
carriageId	String	20	C	旅客运输-出行人证件类型；枚举：201居民身份证；剩余参见《出行人证件类型》
carriageIdNo	String	20	C	旅客运输-出行人证件号码
carriageDateYmd	String	20	C	旅客运输-出行日期，格式：yyyy-MM-dd
carriageLeave	String	80	C	旅客运输-出发地省市区，(出发地+详细地址总长度80)
carriageLeaveAddress	String	80	O	旅客运输-出发地详细地址
carriageArrive	String	80	C	旅客运输-到达地省市区，(到达地+详细地址总长度80)
carriageArriveAddress	String	80	O	旅客运输-到达地详细地址
carriageVehicleType	String	1	C	旅客运输-交通工具类型；枚举：1：飞机；2：火车；3：长途汽车；4：公共交通；5：出租车；6：汽车；7：船舶；9：其他
carriageVehicleGrade	String	20	C	旅客运输-座次等级，仅当交通工具种类为"飞机、火车、船舶"时必传；飞机：公务舱、头等舱、经济舱；火车：一等座、二等座、软席（软座、软卧）、硬座（硬座、硬卧）；船舶：一等舱、二等舱、三等舱

📤 返回参数 - 主参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
merchantInvoiceNo	String	-	O	商户发票商编
invoiceOrderNo	String	-	O	商户开票订单号
tqOrderNo	String	-	O	天阙开票订单号
invoiceWay	String	-	O	开票方式，枚举： 00 直接开票 01 链接开票
linkExpiryDate	String	-	O	开票链接有效期
status	String	-	O	开票状态，枚举： 00 待申请（获取开票链接时返回此状态） 02 开票中 03 开票成功 04 开票失败
linkAddress	String	-	O	开票链接仅invoiceWay=01时返回

📝 请求示例

{
    "reqData":{
        "invoiceOrderNo":"606ff5a971154cd995b0c353e427f61e",
        "invoiceRemark":"我是发票的小备注",
        "merchantInvoiceNo":"EI2023082213171",
        "invoiceSpecialMark":"01",
        "invoiceAmt":"4.6",
        "invoiceWay":"00",
        "buyerInfoListList":[
            {
                "buyerAddress":"河北省保定市",
                "buyerBank":"保定银行",
                "buyerPhone":"010-68143666",
                "buyerTaxNo":"91110107MA01JKC53M",
                "buyerBankAccount":"6213832328921",
                "invoiceTypeCode":"02",
                "buyerName":"河北迅迈测试公司",
                "email":"yang_XX@suixingpay.com"
            }
        ],
        "goodsInfoList":[
            {
                "goodsSpecification":"袋子1",
                "goodsTaxRate":"06",
                "goodsId":"damiid1",
                "goodsPrice":"2.3",
                "goodsUnit":"元1",
                "goodsCode":"3070401000000000000",
                "specialGoodsTaxRate":"06",
                "goodsName":"大米1",
                "goodsNum":"2",
                "subtotalAmount":"4.6"
            }
        ],
        "invoiceSpecialInfoList":[
            {
                "leaseHoldDateEnd":"2024-12-25",
                "leaseDetailAddress":"西山小区01",
                "leaseCrossSign":"N",
                "propertyAreaUnit":"平方米",
                "cph":"豫K 652586H",
                "leaseHoldDateStart":"2025-12-24",
                "leasePropertyNo":"无",
                "leaseAddress":"河南省&郑州市&二七区"
            }
        ]
    },
    "signType":"RSA",
    "version":"2.0",
    "orgId":"26680846",
    "reqId":"08854746780424636774324379880095",
    "timestamp":1736998346364,
    "sign":"JHUdX816CFPEL+QbF479coA/A54h7PgnpCBck8jy7cj7PtSFk2f3PJBUl617hf+XljJW4miPO5wNN7gaWwpS6lokBKkvrOIBci+2nPWJBSfZfdUq+ltm6uS2duHCf42FZKCNuBGA3zyLdGdbHM3Hx/LWh5ITbEjqExgPDZR2bb4="
}

📤 返回示例

{
    "msg":"操作成功",
    "code":"0000",
    "sign":"g3JvMcnKPULGDmfZRNbfnF+kokq+WjwlxPxGBL6RinMgKrwruJ4MJKI/TixdYwwCzm2rpoWYSBae3njvHhvvwbqipjDv+8ZekEi2PSEsGqcSN7o8P8cjjTcfNB+OSYNyoW2+WvaWomE1Pjb7RMw31HKEd04+IwLhdJRamirPobg=",
    "respData":{
        "invoiceOrderNo":"606ff5a971154cd995b0c353e427f61e",
        "merchantInvoiceNo":"EI2023082213171",
        "bizMsg":"成功",
        "bizCode":"0000",
        "invoiceWay":"00",
        "tqOrderNo":"20adcaa8d87447d6a74e1e13b425c451",
        "status":"03"
    },
    "signType":"RSA",
    "orgId":"26680846",
    "reqId":"08854746780424636774324379880095"
}

2. 订单作废接口

POST/merchant/elecInvoice/cancleInvoice

📌 接口说明

生成的开票链接在消费者未申请开票时，合作伙伴可调用此接口作废，作废后订单开票状态更新为：06已作废。

📋 请求参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	15	M	商户发票商编
origInvoiceOrderNo	String	32	C	商户开票订单号，与origTqOrderNo二选一必传
origTqOrderNo	String	32	C	天阙开票订单号，与origInvoiceOrderNo二选一必传

📤 返回参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
merchantInvoiceNo	String	-	O	商户发票商编
origInvoiceOrderNo	String	-	O	商户开票订单号
origTqOrderNo	String	-	O	天阙开票订单号

📝 请求示例

{
    "reqData":{
        "merchantInvoiceNo":"EI2022122751248",
        "origTqOrderNo":"93fb186d2ea94c58a8f25c29e62b8059"
    },
    "signType":"RSA",
    "version":"1.0",
    "orgId":"26680846",
    "reqId":"75878051134773153634397486528907",
    "timestamp":1717380029942,
    "sign":"Ra1r3TT4Fsu1ushifEaO5qeFpXuS2fsIK/BK/3Cg+FGNDk4KmylYH/Gd2tIt8sKjY+FUS0R8ULZTlF43y0V5Z8+m44x0hzAx+JOi2uVZY++9LenkGqVdlytpx4Y3fHAQtyXp6tO5hFEJgGOpgpcuihQVQvydjHYVzpW9e6wbsk0="
}

📤 返回示例

{
    "msg":"操作成功",
    "code":"0000",
    "sign":"SxMn9lzTWGhzg4YusfGaf8a/XM6ZpZXKO0d9v8RDcpPHVmqoua6b2mbisU+eCZJZiTd70EdX8j3E6GHzv28E+7l5BFEXpiKf7yz1/SPY0MQnlBrG6HXYOUMrCHFhLnUs9UGZzkVxbSsWQkg+qEIQOsGmJ75dBMnH3CbmlyHTOsY=",
    "respData":{
        "merchantInvoiceNo":"EI2022122751248",
        "bizMsg":"成功",
        "origTqOrderNo":"93fb186d2ea94c58a8f25c29e62b8059",
        "bizCode":"0000",
        "origInvoiceOrderNo":"FP1789128758935285762"
    },
    "signType":"RSA",
    "orgId":"26680846",
    "reqId":"75878051134773153634397486528907"
}

3. 开票结果查询

POST/merchant/elecInvoice/queryInvoice

📌 接口说明

合作伙伴可调用此接口查询发票信息。

📋 请求参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	15	M	商户发票商编
invoiceOrderNo	String	32	O	商户开票订单号
tqOrderNo	String	32	O	天阙开票订单号

📤 返回参数 - 主参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
merchantInvoiceNo	String	-	O	商户发票商编
tqOrderNo	String	32	O	商户开票订单号
invoiceOrderNo	String	32	O	天阙开票订单号
invoiceInfoList	List	-	C	发票信息list，唯一
invoiceSpecialInfoList	List	-	C	数电特定业务信息
goodsInfoList	List	-	C	商品信息，多个不唯一
buyerInfoListList	List	-	C	购方信息list，唯一

▶ invoiceInfoList（发票信息list，唯一）- 返回

参数名	数据类型	长度限制	必填	说明
invoiceDate	String	-	M	开票日期
amount	String	-	M	应付金额
actualAmount	String	-	M	价税合计
invoiceTotalPrice	String	-	O	合计金额
invoiceTotalTax	String	-	O	合计税额
priceTaxMark	String	-	O	含税标志 00 不含税 01 含税
invoiceRemark	String	-	O	发票备注
invoiceType	String	-	M	发票类型，枚举： 0 蓝票 1 红票
invoiceTypeCode	String	-	M	开票类型，枚举： 01 数电发票（增值税专用发票） 02 数电发票（普通发票）
status	String	-	M	开票状态，枚举： 00 待申请 02 开票中 03 开票成功 04 开票失败 05 已红冲 06 已作废 11 红冲中
invoiceSpecialMark	String	-	M	特殊票种标记 00：普通发票 01：不动产租赁服务发票（数电） 03：建筑服务发票（数电） 09：成品油（数电） 10：旅客运输发票（数电）
errorMsg	String	-	O	开票失败原因
linkAddress	String	-	O	开票链接当status=00时必返
linkExpiryDate	String	-	O	开票链接有效期返回linkAddress时，此参数必返
invoiceNo	String	-	O	发票号码数电票仅返回发票号码
previewInvoiceUrl	String	-	O	发票预览url，访问后可预览发票信息上游生成有延迟，可能为空
einvoiceUrl	String	-	O	电子发票文件下载路径，访问后直接触发下载
einvoiceOfdUrl	String	-	O	ofd电子发票文件下载路径，仅数电发票返回上游生成有延迟，可能为空
einvoiceXmlUrl	String	-	O	xml电子发票文件下载路径，仅数电发票返回上游生成有延迟，可能为空

▶ goodsInfoList（商品信息，多个不唯一）- 返回

参数名	数据类型	长度限制	必填	说明
goodsLineNo	String	-	O	商品行号
goodsName	String	-	O	商品名称
goodsPrice	String	-	O	商品单价
goodsCode	String	-	O	标准税收编码
goodsTaxRate	String	-	O	税率
specialGoodsTaxRate	String	-	O	专票税率本参数针对同一商品专普票税率不一致的场景。
goodsNum	String	-	O	商品数量
subtotalAmount	String	-	O	商品金额，最多支持2位小数
goodsTotalTax	String	-	O	商品税额
goodsUnit	String	-	O	商品单位
goodsSpecification	String	-	O	商品规格
goodsId	String	-	O	外部商品id

▶ buyerInfoListList（购方信息list，唯一）- 返回

参数名	数据类型	长度限制	必填	说明
email	String	-	O	发票接收邮箱
receivePhone	String	-	O	发票接收手机
buyerName	String	-	O	购方名称
buyerTaxNo	String	-	O	购方税号
buyerPhone	String	-	O	购方电话
buyerAddress	String	-	O	购方地址
buyerBank	String	-	O	购方开户行
buyerBankAccount	String	-	O	购方开户行账号

▶ invoiceSpecialInfoList（数电特定业务信息）- 返回

数电特定业务信息，结构与请求参数一致。

参数名	数据类型	长度限制	必填	说明
buildingLocalAddress	String	-	O	建筑服务特定要素-建筑服务发生地
buildingDetailAddress	String	-	O	建筑服务特定要素-建筑服务详细地址
buildingName	String	-	O	建筑服务特定要素-建筑项目名称
buildingLandTaxNo	String	-	O	建筑服务特定要素-土地增值税项目编号
buildingCrossSign	String	-	O	建筑服务特定要素-跨地（市）标志；枚举：Y：是；N：否
kqysssxbgglBm	String	-	O	建筑服务特定要素-跨区域涉税事项报验管理编号
leasePropertyNo	String	-	O	不动产租赁-房屋产权证书/不动产权证号码
leaseAddress	String	-	O	不动产租赁-不动产地址
leaseDetailAddress	String	-	O	不动产租赁-详细地址
leaseCrossSign	String	-	O	不动产租赁-跨地（市）标志，枚举：Y：是；N：否
propertyAreaUnit	String	-	O	不动产租赁-面积单位；面积单位可使用：平方千米、平方米、公顷、亩、㎡、k㎡、h㎡
leaseHoldDateStart	String	-	O	不动产租赁-租赁期起：
leaseHoldDateEnd	String	-	O	不动产租赁-租赁期止：
cph	String	-	O	车牌号
carriageName	String	-	O	旅客运输-出行人
carriageId	String	-	O	旅客运输-出行人证件类型
carriageIdNo	String	-	O	旅客运输-出行人证件号码
carriageDateYmd	String	-	O	旅客运输-出行日期，格式：yyyy-MM-dd
carriageLeave	String	-	O	旅客运输-出发地省市区
carriageLeaveAddress	String	-	O	旅客运输-出发地详细地址
carriageArrive	String	-	O	旅客运输-到达地省市区
carriageArriveAddress	String	-	O	旅客运输-到达地详细地址
carriageVehicleType	String	-	O	旅客运输-交通工具类型；枚举：1：飞机；2：火车；3：长途汽车；4：公共交通；5：出租车；6：汽车；7：船舶；9：其他
carriageVehicleGrade	String	20	C	旅客运输-座次等级，仅当交通工具种类为"飞机、火车、船舶"时必传；飞机：公务舱、头等舱、经济舱；火车：一等座、二等座、软席（软座、软卧）、硬座（硬座、硬卧）；船舶：一等舱、二等舱、三等舱

📝 请求示例

{
  "reqData":{
    "invoiceOrderNo":"77f0f15354864fff844cd8e5292a4b09",
    "merchantInvoiceNo":"EI2022122751248"
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"07436161571294338128934246788161",
  "timestamp":1675839024807,
  "sign":"d9W9/Hhsoa1XPmnhs6uhLKy4oOZ2ShfHbNm1gi0+mIf4laiGHBYDzWN/znqUUOwo8oII6LUCdzhZCHTzzUAVvka+NaDXVnn0IAHrpEmsfUms4altuoazM81qVmkWfJElEYVntoi/h2b7I4bKQO69lFrpND8T7fRyWpWx19jKBNg="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"OgO8EVrApHhJloyWB/VszQxkUWNEc4k1eXV/mHndshbKFJkorM1kXHM5dpdt255ATIU5Akz3GwnAtd/LV4RBAymsTXAamrYSRcrjIpeVo6IT5CgxxTRNjaZFKuAyu0CskrbpgWvD9oHsQdA4PEV0OyTfYbT7w9R1AgWNZnLfKkI=",
  "respData":{
    "invoiceOrderNo":"77f0f15354864fff844cd8e5292a4b09",
    "merchantInvoiceNo":"EI2022122751248",
    "bizMsg":"成功",
    "invoiceInfoList":[
      {
        "previewInvoiceUrl":"http://pre_i.baiwang.com/kaipiao/previewInvoice?invoiceId=16745766622102862012",
        "amount":"46.00",
        "actualAmount":"46.00",
        "einvoiceUrl":"http://fp.baiwang.com/fp/d?d=692F78B1F14B6FAD86B8331BDC3FD4B66345BEF1ABBB15668EC9366B32FD455C",
        "invoiceType":"0",
        "invoiceTypeCode":"026",
        "invoiceDate":"2023-02-08",
        "invoiceNo":"04804531",
        "invoiceCode":"011000100011",
        "invoiceRemark":"你猜我是不是一个发票备注",
        "status":"03"
      }
    ],
    "goodsInfoList":[
      {
        "goodsSpecification":"袋子1",
        "goodsTaxRate":"00",
        "goodsId":"damiid1",
        "goodsPrice":"2.3",
        "goodsUnit":"元1",
        "goodsCode":"3070401000000000000",
        "goodsClassify":"餐饮服务",
        "goodsName":"大米1",
        "goodsNum":"10"
      },
      {
        "goodsSpecification":"袋子2",
        "goodsTaxRate":"03",
        "goodsId":"damiid2",
        "goodsPrice":"2.3",
        "goodsUnit":"元2",
        "goodsCode":"3070401000000000000",
        "goodsClassify":"餐饮服务",
        "goodsName":"大米2",
        "goodsNum":"10"
      }
    ],
    "bizCode":"0000",
    "buyerInfoListList":[
      {
        "buyerAddress":"河北省保定市",
        "buyerBank":"保定银行",
        "buyerPhone":"0312-68143666",
        "buyerTaxNo":"91110107MA01JKC53M",
        "buyerBankAccount":"6213832328921",
        "buyerName":"河北迅迈测试用公司",
        "email":"238057@qq.com"
      }
    ],
    "tqOrderNo":"004bf1b9b43d4ca684cc9753a2e0592a"
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"07436161571294338128934246788161"
}

4. 开票结果通知

回调由平台推送

📌 接口说明

1. 回调触发规则
开票订单成为终态后即触发回调通知（无论开票是否成功）。

2. 回调地址与应答要求
平台会向开票时传入的回调地址推送开票结果通知。收到通知后，需返回以下固定格式的 JSON：
{"code":"success","msg":"成功"} //未正确响应会累计重试10次，依次间隔0S 0.1S 5S 10S 20S 30S 30S 30S 30S 30S

📤 回调参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	-	O	商户发票商编
tqOrderNo	String	32	O	天阙开票订单号
invoiceOrderNo	String	32	O	商户开票订单号
invoiceInfoList	List	-	C	发票信息list，唯一
invoiceSpecialInfoList	List	-	C	数电特定业务信息
goodsInfoList	List	-	C	商品信息，多个不唯一
buyerInfoListList	List	-	C	购方信息list，唯一

各嵌套子参数（invoiceInfoList、goodsInfoList、buyerInfoListList、invoiceSpecialInfoList）结构与"开票结果查询"接口完全一致。

📤 回调示例

{
    "data":{
        "invoiceOrderNo":"fabf8593899445f3b86c7ed380666666",
        "merchantInvoiceNo":"EI2024121286666",
        "invoiceInfoList":[
            {
                "amount":"20.00",
                "priceTaxMark":"01",
                "linkExpiryDate":"999",
                "actualAmount":"20.00",
                "einvoiceUrl":"http://fp.baiwang.com/format/d?d=AE7A8B0A7178E270AFF19F6A2213045213500E8BA248AC79BE48507E86066666",
                "invoiceTotalTax":"1.14",
                "invoiceDate":"20250416152666",
                "invoiceRemark":"我是发票的小备注",
                "invoiceTotalPrice":"18.86",
                "invoiceType":"0",
                "invoiceTypeCode":"02",
                "invoiceNo":"25112000000076739782",
                "status":"03"
            }
        ],
        "goodsInfoList":[
            {             
                "goodsTaxRate":"06",
                "goodsId":"damiid4",
                "goodsUnit":"元",
                "specialGoodsTaxRate":"06",
                "goodsName":"大米",
                "goodsNum":"3",
                "goodsLineNo":"4",
                "subtotalAmount":"6",       
                "goodsSpecification":"袋子",
                "goodsPrice":"2",
                "goodsTotalTax":"0.34",
                "goodsCode":"3070401000000000000"
            }
        ],
        "buyerInfoListList":[
            {
                "buyerAddress":"河北省保定市实兴大街30号院7号楼2层130 号",
                "buyerBank":"保定银行股份有限公司保定分行营业部",
                "receivePhone":"",
                "buyerPhone":"0312-68143666",
                "buyerTaxNo":"91110107MA01JKC53M",
                "buyerBankAccount":"9550880214277500174",
                "buyerName":"河北迅迈网络科技有限公司",
                "email":"guan_XX@pay.com"
            }
        ],
        "tqOrderNo":"11abdca6cb9448f7ab989ccdca8db468"
    },
    "sign":"SbmbcKmUzMK9Q6QtSBPCQvHyIhsGUURsJpCDbhdooGLky9pvr0XBohXOMjKlK+CNPqVBaU5OU0CVfkijVQITXQp74B7D8PIUn+nRabL9Qeua79V1lnmlhwGluZ1idK4XhBSIGwu3KklpyDn6mBuKenxBIzrQux8QAUl6f42TIZs="
}

5. 云抬头

POST/merchant/elecInvoice/titleSearch

📌 接口说明

合作伙伴可调用此接口查询企业信息。

📋 请求参数

参数名	数据类型	长度限制	必填	描述
titleName	String	-	M	企业名称

📤 返回参数 - 主参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
titleList	List	-	M	企业信息list，多个不唯一（最大五个）

▶ titleList（企业信息list，多个不唯一（最大五个））- 返回

参数名	数据类型	长度限制	必填	说明
name	String	-	M	企业名称
taxId	String	-	M	企业税号
bank	String	-	M	开户银行
bankAccount	String	-	M	开户账号
location	String	-	M	企业地址
mobilePhone	String	-	M	联系电话
city	String	-	O	市
county	String	-	O	区（县）
province	String	-	O	省份
frequency	String	-	O	使用频率
score	String	-	O	相似度

📝 请求示例

{
  "reqData":{
    "titleName":"百度"
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"53252425257343263862456864579397",
  "timestamp":1675839432230,
  "sign":"SBeH0cJtZgCzqkw6xaLW3KHDOZNbz0YNT9C9YM5j/Mg853cYhJST+nwYXv4f9/PIWRMGAwgHOwqaf6tgo++Kwo8B55jmXbG0ndFO8ASgZWHN8R7Wlhr58+yrVxZ6u4nFAC8smuGtUiN4I7iu3wdoFWf3ng5ZGXQdHy4jRqKSAjQ="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"SKkcXb+P686rJuwW40mPBAUAnBw+ty7zkfvTL+jYCyx9+cLtXITtexw3S3ekr5+CeJ1WeqBZasjwUihSKf4+2WjL1viEHotrHXOerMctJJv1vjz3KsBIXKXPk05uVq5ROgr6LbUKZVFFGqqOPo02S1jXfuFA3F2JG3zXhKQJsqE=",
  "respData":{
    "bizMsg":"SUCCESS",
    "bizCode":"0000",
    "titleList":[
      {
        "bankAccount":"",
        "score":"22.010127453358315",
        "bank":"",
        "mobilePhone":"18851241188",
        "province":"江苏省",
        "city":"宿迁市",
        "taxId":"91321322MA1MKXTQ5P",
        "county":"沭阳县",
        "name":"沭阳百度网咖有限公司",
        "location":"沭阳县中城美地小区",
        "frequency":"22"
      },
      {
        "bankAccount":"",
        "score":"21.319857453358317",
        "bank":"",
        "mobilePhone":"62915902",
        "province":"安徽省",
        "city":"合肥市",
        "taxId":"91340123MA2MURY20F",
        "county":"肥西县",
        "name":"肥西一百度网咖",
        "location":"合肥经开区桃花工业园耕耘路多伦多花园12号楼110.111.112号",
        "frequency":"22"
      },
      {
        "bankAccount":"",
        "score":"21.272982453358317",
        "bank":"",
        "mobilePhone":"13948554855",
        "province":"内蒙古省",
        "city":"通辽市",
        "taxId":"911505235946198629",
        "county":"开鲁县",
        "name":"开鲁县一百度网苑",
        "location":"内蒙古自治区通辽市开鲁县开鲁镇工农街7-5号",
        "frequency":"22"
      },
      {
        "bankAccount":"",
        "score":"21.11313927355399",
        "bank":"",
        "mobilePhone":"",
        "province":"山西省",
        "city":"晋城市",
        "taxId":"91140522MA0GRBGL2K",
        "county":"阳城县",
        "name":"阳城县百度网咖网吧",
        "location":"山西省晋城市阳城县西池街165号",
        "frequency":"20"
      },
      {
        "bankAccount":"",
        "score":"20.927418453358317",
        "bank":"",
        "mobilePhone":"",
        "province":"河北省",
        "city":"张家口市",
        "taxId":"91130702MA0CEHHW0E",
        "county":"桥东区",
        "name":"张家口百度网城",
        "location":"张家口市桥东区建设东街怡园小区5号楼底商",
        "frequency":"22"
      }
    ]
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"53252425257343263862456864579397"
}

6. 发票信息重新推送

POST/merchant/elecInvoice/sendInvoice

📌 接口说明

合作伙伴可调用此接口重新向消费者邮箱推送发票信息。

📋 请求参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	-	M	商户发票商编
invoiceOrderNo	String	-	C	商户开票订单号同tqOrderNo二选一必传
tqOrderNo	String	-	C	天阙开票订单号同invoiceOrderNo二选一必传
email	String	30	C	邮箱邮箱和手机号需必传其一
receivePhone	String	11	C	接收手机号邮箱和手机号需必传其一

📤 返回参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息

📝 请求示例

{
  "reqData":{
    "invoiceOrderNo":"77f0f15354864fff844cd8e5292a4b09",
    "merchantInvoiceNo":"EI2022122751248",
    "email":"23803@.qqcom"
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810",
  "timestamp":1675839335060,
  "sign":"dvGUpY+bFJpRjLakO8cw2t++bof3tkPcGbEqS5pjKATvvDSi+lWBtVyFHnf5FnnnbJhpnrNfRt+y38CYXR9av7z7d7Lsfz+z+uiLdXbSevanVUEcdSnAxtcfI2N4KAhCW6bu9n2emed3yg/XAKsl28lk2h/tT/tyPFVz5tboDLw="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"iKQrSDPFvtVyMx17BBl2sjuNUKV34LkTY4S8qZqs0LAUJqYXxnMeYEGnlo/wrYZSGEHwjAI2lWgV8124UH816I4M4P65lzA+Hc8n+uDlZ3/r8FM2b7qTjMyJk7O6ekWrO0tr286JORC5uGxATT4KeqxpzAJ3XUQ1X2ZwmFuy38I=",
  "respData":{
    "bizMsg":"推送成功",
    "bizCode":"0000"
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810"
}

7. 获取数电账号管理URL

POST/merchant/elecInvoice/getEtaxUserUrl

📌 接口说明

合作伙伴可调用此接口获取数电账号管理URL，进行数电账号的添加、登录、认证。

📋 请求参数

参数名	数据类型	长度限制	必填	说明
merchantInvoiceNo	String	-	M	商户发票商编

📤 返回参数

参数名	数据类型	长度限制	必填	说明
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
etaxUserUrl	String	-	O	数电账号管理URL，用于添加、登录、认证账号

📝 请求示例

{
  "reqData":{
    "merchantInvoiceNo":""
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810",
  "timestamp":1675839335060,
  "sign":"dvGUpY+bFJpRjLakO8cw2t++bof3tkPcGbEqS5pjKATvvDSi+lWBtVyFHnf5FnnnbJhpnrNfRt+y38CYXR9av7z7d7Lsfz+z+uiLdXbSevanVUEcdSnAxtcfI2N4KAhCW6bu9n2emed3yg/XAKsl28lk2h/tT/tyPFVz5tboDLw="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"iKQrSDPFvtVyMx17BBl2sjuNUKV34LkTY4S8qZqs0LAUJqYXxnMeYEGnlo/wrYZSGEHwjAI2lWgV8124UH816I4M4P65lzA+Hc8n+uDlZ3/r8FM2b7qTjMyJk7O6ekWrO0tr286JORC5uGxATT4KeqxpzAJ3XUQ1X2ZwmFuy38I=",
  "respData":{
    "bizMsg":"成功",
    "bizCode":"0000",
    "etaxUserUrl":""
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810"
}

8. 申请红字确认单（数电红冲）

POST/merchant/elecInvoice/applyConfirmUuid

📌 接口说明

合作伙伴可调用此接口操作数电票的红冲。

数电票红冲逻辑是先申请红字确认单，申请成功之后才会进行红冲，具体逻辑如下：

- 如果业务响应成功（bizCode=0000时，百望云通道redConfirmStatus均为01）此时看是否返回红票号码，如果返回则红票开具成功。如果没返回则红票为开票中，我司会自动补偿，合作伙伴需调用开票结果查询接口获取终态。红字确认单申请成功后请不要重复申请；

- 如果业务响应失败（bizCode!=0000）表示红字确认单申请失败，请根据错误原因修正信息后再次调用此接口即可；

📋 请求参数

参数名	数据类型	长度限制	必填	说明
merchantInvoiceNo	String	-	M	商户发票商编
origInvoiceOrderNo	String	-	O	原商户开票订单号
origTqOrderNo	String	-	O	原天阙开票订单号原商户开票订单号、原天阙开票订单号必传其一
redIssueReason	String	-	C	冲红原因，枚举值： 01 开票有误 02 销货退回 03 服务中止 04 销售折让
taxUserName	String	11	O	电局账号传当前处于登录、认证成功的电局账号以保证不会因登录、认证失效而导致申请失败，如不传，百望会根据一定规则自动取值。
deliverFlag	String	-	O	红票发送方式 00 使用其他邮箱、手机发送 01 使用原蓝票邮箱、手机发送不传默认01
buyerEmail	String	30	C	红票接收邮箱 deliverFlag=00则邮箱和手机必传其一
buyerPhone	String	11	C	红票接收手机号 deliverFlag=00则邮箱和手机必传其一

📤 返回参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
merchantInvoiceNo	String	-	M	商户发票商编
origInvoiceOrderNo	String	-	O	原商户开票订单号
origTqOrderNo	String	-	O	原天阙开票订单号
redConfirmStatus	String	-	O	申请状态，枚举 01申请完成 02申请失败
redConfirmUuid	String	-	O	红字确认单UUID
status	String	-	O	红字确认单状态，枚举 01 无需确认 02 销方录入待购方确认 03 购方录入待销方确认 04 购销双方已确认 05 作废（销方录入购方否认） 06 作废（购方录入销方否认） 07 作废（超 72 小时未确认） 08 作废（发起方已撤销） 09 作废（确认后撤销） 10 作废（异常凭证）红字确认单状态为01时基本都能直接红冲，为02/03时需要购方/销方登录电子税务局确认，确认后状态更新为04则会红冲成功
redIssueReason	String	-	M	冲红原因，枚举 01 开票有误 02 销货退回 03 服务中止 04 销售折让
redInvoiceNo	String	-	O	红字发票号码数电发票红冲完成后会返回此参数
tqOrderNo	String	-	O	天阙红冲订单号数电发票申请红字确认单完成后会返回此参数，可用于查询红票信息
invoiceOrderNo	String	-	O	商户红冲订单号数电发票申请红字确认单完成后会返回此参数，可用于查询红票信息

📝 请求示例

{
  "reqData":{
    "merchantInvoiceNo":""
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810",
  "timestamp":1675839335060,
  "sign":"dvGUpY+bFJpRjLakO8cw2t++bof3tkPcGbEqS5pjKATvvDSi+lWBtVyFHnf5FnnnbJhpnrNfRt+y38CYXR9av7z7d7Lsfz+z+uiLdXbSevanVUEcdSnAxtcfI2N4KAhCW6bu9n2emed3yg/XAKsl28lk2h/tT/tyPFVz5tboDLw="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"iKQrSDPFvtVyMx17BBl2sjuNUKV34LkTY4S8qZqs0LAUJqYXxnMeYEGnlo/wrYZSGEHwjAI2lWgV8124UH816I4M4P65lzA+Hc8n+uDlZ3/r8FM2b7qTjMyJk7O6ekWrO0tr286JORC5uGxATT4KeqxpzAJ3XUQ1X2ZwmFuy38I=",
  "respData":{
    "bizMsg":"成功",
    "bizCode":"0000",
    "etaxUserUrl":""
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"68713873819470836332539298212810"
}

9. 红字确认单查询

POST/merchant/elecInvoice/queryConfirmUuid

📌 接口说明

合作伙伴可调用此接口查询红字信息申请结果

📋 请求参数

参数名	数据类型	长度限制	必填	说明
merchantInvoiceNo	String	-	M	商户发票商编
origInvoiceOrderNo	String	-	O	原商户开票订单号
origTqOrderNo	String	-	O	原天阙开票订单号原商户开票订单号、原天阙开票订单号必传其一
taxUserName	String	11	O	电局账号传当前处于登录、认证成功的电局账号以保证能查询成功，如不传，百望会根据一定规则自动取值。

📤 返回参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
merchantInvoiceNo	String	-	M	商户发票商编
origInvoiceOrderNo	String	-	O	原商户开票订单号
origTqOrderNo	String	-	O	原天阙开票订单号
redConfirmStatus	String	-	O	申请状态，枚举 01申请完成 02申请失败
redConfirmUuid	String	-	O	红字确认单UUID
status	String	-	O	红字确认单状态，枚举（同申请接口）
redIssueReason	String	-	M	冲红原因，枚举 01 开票有误 02 销货退回 03 服务中止 04 销售折让
redInvoiceNo	String	-	O	红字发票号码数电发票红冲完成后会返回此参数
einvoiceUrl	String	-	O	红票pdf格式下载路径上游生成有延迟，可能为空
einvoiceOfdUrl	String	-	O	红票ofd格式下载路径上游生成有延迟，可能为空
einvoiceXmlUrl	String	-	O	红票xml格式下载路径上游生成有延迟，可能为空
tqOrderNo	String	-	O	天阙红冲订单号数电发票申请红字确认单完成后会返回此参数，可用于查询红票信息
invoiceOrderNo	String	-	O	商户红冲订单号数电发票申请红字确认单完成后会返回此参数，可用于查询红票信息

📝 请求示例

{
  "reqData":{
    "merchantInvoiceNo":"EI2022122751248",
    "origInvoiceOrderNo":"77f0f15354864fff844cd8e5292a4b09"
  },
  "signType":"RSA",
  "version":"1.0",
  "orgId":"26680846",
  "reqId":"88838425264468849797500538473122",
  "timestamp":1675839237385,
  "sign":"M0tvW7Pr4U50/8x75LoH0euLL8byTLAO/VPLqyNcNQEsmAI5fAZ9by2473hjamX015QvDwjOKqYkb4CPDFfJnPyT0G6ixIdwHwKg2r5rbToB2xbvRL82Jov4xQdOOASZWUwuXVg+J1tEwRSf3hJzHPeIVqO/GjQeN936IfixeSg="
}

📤 返回示例

{
  "msg":"操作成功",
  "code":"0000",
  "sign":"VqIIDKG+23xroANwkvIVhlqlx0g7gyfgF2y9nyooa03R8X8i1yiPduhZi7WsVvotA8Bb3xwhfCD0iQ6FJCCHrHs/kCLXyBYwmkMa1CqjRCHDev679PQwlZ7Bye9VyJIFVie+UMJSlTSUw8Gee+O5W7CSlMNY5l7EYk1ekckmabM=",
  "respData":{
    "refundInvoiceOrderNo":"7e8cd54e0b26445fb077822c1c2a16bb",
    "merchantInvoiceNo":"EI2022122751248",
    "refundTqOrderNo":"8b03c01f4b1044e9a901da896bd431d8",
    "bizMsg":"成功",
    "origTqOrderNo":"004bf1b9b43d4ca684cc9753a2e0592a",
    "bizCode":"0000",
    "origInvoiceOrderNo":"77f0f15354864fff844cd8e5292a4b09",
    "status":"03"
  },
  "signType":"RSA",
  "orgId":"26680846",
  "reqId":"88838425264468849797500538473122"
}

10. 登录探活

POST/merchant/elecInvoice/tanHuo

📌 接口说明

合作伙伴调用此接口可以获取电局账号的登录状态

📋 请求参数

参数名	数据类型	长度限制	必填	说明
merchantInvoiceNo	String	15	M	商户发票商编
taxUserName	String	11	M	电局账号
proCd	String	2	O	纳税省份枚举参见：纳税省份

📤 返回参数

参数名	数据类型	长度限制	必填	说明
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
checkCode	String	1	M	探活返回code： 1：跟电票连接保持中 2：账号登录其他税号 3：跟电票连接断开

📝 请求示例

{
    "reqData":{
        "proCd":"11",
        "merchantInvoiceNo":"EI2024121228000",
        "taxUserName":"15525252525"
    },
    "signType":"RSA",
    "version":"1.0",
    "orgId":"90100578",
    "reqId":"97903870679926811752303929980702",
    "timestamp":1735024217705,
    "sign":"a8VNqfjPwrq7zEaVlO47eqxkryOs65pjmx/Vuc1sbiWBFetEvdNGoAHrgVEMWAa38wXnxi7m/gOTEHkoihJ+cNTmU6AoAUvpcVYlZ4ffOBiZIXu6x/FDrzb/jBLpWa5JgfItVm2npNNrFjB6b72N88/cRX/YO1s2rRn19Xgi9p8="
}

📤 返回示例

{
    "msg":"操作成功",
    "code":"0000",
    "sign":"DbEEdkqUfwhaPUmr/IHJ+FW0G/zfKkpPQjatR7nGI7hwNPX5kGZdQLZSa0APqBem8DnBRD2irCHLvok7a2RtD3+ZcQu9u9Gbudtlwhs3OhUb23zleKLCpmt1iPKYKqpF0cO3DHWJlcp/4kieAwf7EUwDgACUwi+zcAnpI1PXs34=",
    "respData":{
        "bizMsg":"成功",
        "bizCode":"0000",
        "checkCode":1
    },
    "signType":"RSA",
    "orgId":"90100578",
    "reqId":"97903870679926811752303929980702"
}

11. 判断是否需要扫脸认证

POST/merchant/elecInvoice/getScanFaceFlag

📌 接口说明

合作伙伴调用此接口可以判断当前电局账号是否需要扫脸认证

📋 请求参数

参数名	数据类型	长度限制	必填	说明
merchantInvoiceNo	String	15	M	商户发票商编
taxUserName	String	11	M	电局账号

📤 返回参数

参数名	数据类型	长度限制	必填	说明
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
scanFaceFlag	String	-	M	是否需要扫脸 Y:需要扫脸认证 N:无须扫脸认证
taxUserName	String	-	M	电局账号
taxRealName	String	-	M	电局实名

📝 请求示例

{
    "reqData":{
        "merchantInvoiceNo":"EI2024121228000",
        "taxUserName":"15525252525"
    },
    "signType":"RSA",
    "version":"1.0",
    "orgId":"90100578",
    "reqId":"20661396740030247748125455361042",
    "timestamp":1735024610951,
    "sign":"LgrWapU9saqqARG4+nLioS93HEgtgoUnkhEOvBgpqXsWeZbPq2ITIOAZ9SlD6Ii7JRSPeIiz6136Aj2tP1gbqFFx5PdWYyVdUocvymoZbFRtWQIgr9XeIQrGddkYU9BcxTZd9aBUNB0s7lpxNlQyY5uw5OeVgdrIlZUgpNibNos="
}

📤 返回示例

{
    "msg":"操作成功",
    "code":"0000",
    "sign":"hrvT8yEK/SzdEfwjdGFqEz0UBeb8Txjl9iw0WpMjGBHu6XC9DjspmmZefHUGEUwQ6zdrd+nOs0D4/qeS1rflb9G6XDl3Yk+PK519BUXuuiFOpCjMtHm1qsUp37z67XVyelI0AFcONbLoUb56ieJqA+wDplsWUk8aMhBSOFgIQ7E=",
    "respData":{
        "bizMsg":"成功",
        "bizCode":"0000",
        "scanFaceFlag":"N",
        "taxUserName":"15525252525",
        "taxRealName":"张三"
    },
    "signType":"RSA",
    "orgId":"90100578",
    "reqId":"20661396740030247748125455361042"
}

12. 开票员信息查询接口

POST/merchant/elecInvoice/getIssuerInfo

📌 接口说明

合作伙伴可调用此接口获取通过数电URL添加的开票员信息

📋 请求参数

参数名	数据类型	长度限制	必填	描述
merchantInvoiceNo	String	15	M	商户发票商编

📤 返回参数 - 主参数

参数名	数据类型	长度限制	必填	描述
bizCode	String	-	M	业务响应码
bizMsg	String	-	M	业务响应信息
invoiceIssuerList	List	-	M	开票员信息

▶ invoiceIssuerList（开票员信息）- 返回

参数名	数据类型	长度限制	必填	描述
userName	String	-	O	开票员姓名
userAccount	String	-	O	电局账号
proCd	String	-	O	纳税省份枚举参见：纳税省份
isDefault	String	-	O	是否默认开票员 00 否 01 是

📝 请求示例

{
    "reqData": {
        "merchantInvoiceNo": "EI2024122431314"
    }, 
    "signType": "RSA", 
    "version": "2.0", 
    "orgId": "28658969", 
    "reqId": "70931394760371384318624703608150", 
    "timestamp": 1756265902250, 
    "sign": "qqPAvMQydpwGJcAHRwKzkgy/IgctbsevNUiDMArsgXYU48vnyARn8gZu/kZIylVvnvXr1LQv04APaY8pREOryOprDt8MQoR85BWQdhOeQ2uztqIhNN1pui7QNuo+sCGlrYrRQDQ/dbpdcdJEx61/rIc6FJ1C6h0Y517O+fgYyiQ="
}

📤 返回示例

{
    "msg": "操作成功", 
    "code": "0000", 
    "sign": "MrifFmVKaVNMOTii1wLm30dcsMkBQ3a3mjMDyGEqmm9gWI/ZDhhGwNo0KY74nqFLA1zkMhfThWtDk25IKOdqszb0qB7irAV39/8GLkocuQcyNfTCRZOpbTegUujvtKdU89b+oeFniK0EBGLLGDGnb04g0JTn2H6QRWtDBjJljgvJ5qJo0790vLCaSwK8XdfGmoNc6tFSv015aFH/Q+KKhp5MYRikZX6PRYZ5LaYb+J+Lnh4nhdVc2pBAPBtrx28M9EHFYqIaxITaDhIfmO0PVn1V6YN5Z0hMfzi7TrcNklj0b3lK1XI27833HPXFDwNcG/naZED9t9Vst0nwIxcpfA==", 
    "respData": {
        "invoiceIssuerList": [
            {
                "proCd": "11", 
                "isDefault": "01", 
                "userAccount": "15838015698", 
                "userName": "张小明"
            }
        ], 
        "bizMsg": "成功", 
        "bizCode": "0000"
    }, 
    "signType": "RSA", 
    "orgId": "28658969", 
    "reqId": "70931394760371384318624703608150"
}

开票配置

一、数电发票开票配置

1. 【推荐】通过接入我司“获取数电账号管理url”接口配置

2. 【不推荐】通过百望平台配置

商户开票前期配置

2.1 获取百望平台账号密码

2.2 维护数电账号信息

2.2.3 注意事项

2.2.4 如何提升电局账号登录、认证时效

3. 如何提升登录时效

4. 如何提升认证时效

接口文档

1. 开票接口

📌 接口说明

📋 请求参数 - 主参数

建筑服务特定要素（invoiceSpecialMark=03时必传）

不动产租赁特定要素（invoiceSpecialMark=01时必传）

旅客运输特定要素（invoiceSpecialMark=10时）

📤 返回参数 - 主参数

2. 订单作废接口

📌 接口说明

📋 请求参数

📤 返回参数

3. 开票结果查询

📌 接口说明

📋 请求参数

📤 返回参数 - 主参数

4. 开票结果通知

📌 接口说明

📤 回调参数

5. 云抬头

📌 接口说明

📋 请求参数

📤 返回参数 - 主参数

6. 发票信息重新推送

📌 接口说明

📋 请求参数

📤 返回参数

7. 获取数电账号管理URL

📌 接口说明

📋 请求参数

📤 返回参数

8. 申请红字确认单（数电红冲）

📌 接口说明

📋 请求参数

📤 返回参数

9. 红字确认单查询

📌 接口说明

📋 请求参数

📤 返回参数

10. 登录探活

📌 接口说明

📋 请求参数

📤 返回参数

11. 判断是否需要扫脸认证

📌 接口说明

📋 请求参数

📤 返回参数

12. 开票员信息查询接口

📌 接口说明

📋 请求参数

📤 返回参数 - 主参数