3.3.4.数电红冲结果查询 - 百旺金穗云-SaaS标准化接口

接口描述	主动查询红冲结果
请求路径	/cloud/queryRedInvRes
开放权限	所有企业
调用方式	POST
参数方式	Base64（JSON格式）
重要说明
业务范围	数电
接口类型	同步

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

qyId

string

企业唯一标识

必需

ddlsh

string

红字申请订单流水号

必需

dlzh

string

登录账号

必需

示例

{
  "qyId": "企业唯一标识",
  "ddlsh": "红字申请订单流水号",
  "dlzh": "登录账号"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/queryRedInvRes' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "qyId": "企业唯一标识",
    "ddlsh": "红字申请订单流水号",
    "dlzh": "登录账号"
}'

返回响应

🟢200成功

application/json

Body

code

string

返回代码

必需

0成功，其它失败

message

string

返回信息

必需

成功/失败

renson

string

描述

必需

失败原因具体描述

data

object

必需

ddlsh

string

订单流水号

必需

红字申请流水号

status

string

状态代码

必需

1 红冲申请中 2 待确认 3 已作废 4 红冲开具成功 5 红冲申请失败 1004 需要登录 1003 需要认证

ycyy

string

异常原因

可选

hzfpxxqrdbh

string

红字申请单编号

可选

uuid

string

红字申请成功UUID

可选

zzsytDm

string

增值税用途状态

可选

00 已勾选未确认 01 已确认 03 未勾选

xfsytDm

string

消费税用途状态

可选

00 未勾选

fprzztDm

string

发票入账状态

可选

00 未入账 01 已入账

hzqrxxztDm

string

红字确认信息状态

必需

01无需确认； 02 销方录入待购方确认 03 购方录入待销方确认 04 购销方都已确认 05 作废(销方录入购方否认) 06 作废(购方录入销方否认) 07 作废(超72小时未确认) 08 作废(发起方已撤销) 09 作废(确认后撤销) 10 作废(异常凭证)

ykjhzfpbz

string

已开具红字发票标记

可选

Y 已开 N 未开

fpdm

string

发票代码

必需

fphm

string

发票号码

必需

qdfphm

string

全电发票号码

必需

kprq

string

开票日期

必需

pdf

string

pdf地址

可选

ofdurl

string

ofd地址

可选

xmlurl

string

xml地址

可选

jfdz

string

局端交付地址

必需

局端交付地址，打开为局端发票下载页面

gsPdf

string

公司版式pdf地址

可选

百旺版式，第三方开通百旺版式该节点才有值

gsOfdUrl

string

公司版式ofd地址

可选

百旺版式，第三方开通百旺版式该节点才有值

示例

{
  "code": "0",
  "message": "成功",
  "renson": "",
  "data": {
    "ddlsh": "订单流水号",
    "status": "1红冲申请中 2待确认 3已作废 4红冲开具成功 5 红冲失败 1004 需要登录",
    "ycyy": "异常原因",
    "hzfpxxqrdbh": "红字申请单编号",
    "uuid": "红字申请成功UUID",
    "zzsytDm": "增值税用途状态",
    "xfsytDm": "消费税用途状态",
    "fprzztDm": "发票入账状态",
    "hzqrxxztDm": "红字确认信息状态",
    "ykjhzfpbz": "已开具红字发票标记",
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "qdfphm": "全电发票号码",
    "kprq": "开票日期",
    "pdf": "pdf地址",
    "ofdurl": "ofd地址",
    "xmlurl": "xml地址",
    "jfdz": "局端交付地址",
    "gsPdf": "pdf地址",
    "gsOfdUrl": "ofd地址"
  }
}