税务数字化管理平台
  1. 销项
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 更新记录
    • 常见问题
    • 接口码表
    • 销项
      • 税控
        • 发票领购查询
        • 发票作废
        • 空白发票作废
        • 红字信息表申请
        • 红字信息表查询
        • 红字信息表撤销
        • 红字信息表准备信息查询
        • 发票开具(专、普、电)
      • 数电
        • 红字确认单申请准备信息查询
        • 红字确认单申请
        • 查询红字确认单详细信息
        • 红字确认单撤销
        • 红字确认单查询
        • 红字确认单确认
        • 异常红字确认单下载
        • 全电发票开具
        • 人脸识别二维码
        • 获取全电开票结果
        • 获取全电全票面数据
        • 全电认证
        • 短信认证
        • 全电交付
        • 成品油库存台账查询
        • 全电纸质发票作废
        • 获取人脸识别结果
        • 获取红字确认单申请结果
        • 获取数电发票下载地址
        • 红字全电发票开具
        • 获取纸质发票打印XML
        • 发送发票数据到控件
        • 开启打印窗口
        • 蓝字发票数据统计
        • 版式文件下载
        • 批量红字确认单下载
        • 获取当前发票代码号码(数电纸票)
        • 查询跨区域涉税事项报验管理编码
        • 检查账号在线状态
        • 查询身份授权(用户是否需要人脸认证)状态
      • 乐企
        • 获取批量预赋码信息
        • 查询授信额度
        • 下载/退回授信额度
        • 调整授信额度有效期
        • 查询纳税人风险信息
        • 查询纳税人基本信息
        • 查询可用税率信息
        • 查询数字化电子红字确认单列表信息
        • 数字化电子红字确认单确认
        • 查询数字化电子红字确认单明细信息
        • 再次上传数电发票
        • 废弃乐企异常发票
        • 数电发票开具
        • 数电发票开具(实时开票)
        • 数字化电子红字确认单申请
      • 扫码开票
        • 二维码生成规则
        • 扫码开票订单导入
        • 扫码开票订单查询
        • 扫码开票订单作废
      • 发票查询
        POST
      • 单张发票查询
        POST
      • 商品导入
        POST
      • 客户导入
        POST
      • 批量待开导入
        POST
      • 待开分页查询
        POST
      • 批量单据导入
        POST
      • 单据分页查询
        POST
      • 账号注册
        POST
      • 全票种开具
        POST
      • 抬头联想
        POST
      • 单张发票修复
        POST
  1. 销项

单据分页查询

POST

1、接口及场景描述#

接口描述: 为企业提供查询百旺通系统中的单据数据
是否支持数电及税控发票:全部支持

2、请求参数#

字段名称必选类型长度字段含义及备注
method是string请求方法名
object是object请求数据
pageNum否integer页码 [大小: 1~] 默认为1
pageSize否integer每页显示数量 [大小: 1~5000] 默认为10
request是object请求对象
djly否string1单据来源 2:单据导入 3:接口对接
djlsh否string255单据流水号
ghdwmc否string300购货单位名称
ghdwsbh否string26购货单位识别号
bz否string460备注
kpsqr否string开票申请人
djlx否array4单据类型
004:专票、
007:普票、
026:电普票
81:全电专
82:全电普
kplx否string1开票类型
djzt否object[]单据状态
0待开具
1已开具
2开具失败
3作废失败
4已作废
5已合并
6开具中
7部分作废
8 部分开具
9已还原
cfOrHbType否object[]拆分合并标识
0:未处理
1:已合并
2:已拆分
zsfs否string1征收方式 0:普通征税 2:差额征税
hjjeq否string合计金额起
hjjez否string合计金额止
hjseq否string合计税额起
hjsez否string合计税额止
jshjq否string价税合计起
jshjz否string价税合计止
sqrqq否string申请日期起 格式:yyyy-MM-dd
sqrqz否string申请日期止 格式:yyyy-MM-dd

3、返回参数#

字段名称是否必返回类型长度字段含义及备注
code是string返回代码
data是object返回数据
count是integer返回个数
msg是string返回消息
bz否string460备注
djlsh是string255单据流水号
djlx是string4单据类型
djly是string1单据来源
2:单据导入
3:接口对接
djzt是string1单据状态
0待开具
1已开具
2开具失败
3作废失败
4已作废
5已合并
6开具中
7部分作废
8 部分开具
9已还原
fhr否string复核人
fyxm是object[]费用项目 详见:3.1、返回参数(fyxm数据信息)
ghdwsbh是string26购货单位识别号
ghdwmc是string300购货单位名称
ghdwdzdh否string300购货单位地址电话
ghdwyhzh否string200购货单位银行帐号
hjje是string16合计金额
hjse是string16合计税额
jshj是string16价税合计
kce否string16差额 扣除额zsfs为2时此项必返回
kplx是string1开票类型
kpr否string开票人
kpsqr否string开票申请人
qdbz是string1清单标志
sjh否string11手机号
skr否string收款人
sqrq是string申请日期 格式:yyyyMMdd
xhdwsbh是string26销货单位识别号
xhdwmc是string300销货单位名称
xhdwdzdh否string300销货单位地址电话
xhdwyhzh否string200销货银行银行账号
yx否string40邮箱
zsfs是string1征税方式0:普通征税 2:差额征税
gmfdz否string300数电-地址
gmflxdh否string60数电-电话
gmfkhh否string120数电-开户行
gmfyhzh否string100数电-银行账号
xhdwdz否String300销方地址
xhdwdh否String60销方电话
xhdwkhh否String120销方开户行
xhdwzh否String100销方账户
hblsh否string合并流水号 被合并的流水号cfOrHbType为合并单据时有值
cfOrHbType是string1拆分合并标识
0:未处理
1:已合并
2:已拆分
3:合并单据
fp是object[]单据关联的待开数据,包含已开和未开
详见:3.2、返回参数(fp数据信息)

3.1、返回参数(fyxm数据信息)#

字段名称是否必返回类型长度字段含义及备注
dj否string16单价
dw否string300单位
fphxz是string1发票行性质
ggxh否string40规格型号
hsbz是string1含税标志 0:不含税1:含税
je是string16金额
lslbs否string1零税率标识 空代表无,1:出口免税和其他免税优惠政策,2:不征增值税,3:普通零税率
se否string16税额
sl是string8税率
spbm是string19商品编码
spmc是string600商品名称
spsl否string16商品数量
spsm否string19商品税目
yhzcbs否string1优惠政策标识,0:未使用1:使用
zxbm否string自行编码
zzstsgl否string50增值税特殊管理 如果yhzcbs为1时,此项必返回增值税特殊管理不征税、免税、
按5%简易征收减按1.5%计征、
按3%简易征收、
按5%简易征收、简易征收、先征后退、100%先征后退、
50%先征后退、即征即退30%、
即征即退50%、
即征即退70%、
即征即退100%、
超税负3%即征即退、
稀土产品、
超税负8%即征即退、
超税负12%即征即退、
超税负6%即征即退

3.2、返回参数(fp数据信息)#

字段名称是否必返回类型长度字段含义及备注
fpdm否string12发票代码
fphm否string20发票号码
kprq否string开票日期 格式:yyyyMMddHHmmss
fpzt是string2发票状态
00:已开具的正数发票 、
01:已开具的负数发票、
02:未开具发票的作废发票、
03:已开具正数发票的作废发票、
04:已开具负数发票的作废发票
-1:正数发票,数据缺失
若为待开数据 对应状态为:
01:未开具正数发票
02:未开具负数发票
03:拆分所产生的发票数据
fplxdm是string4发票类型代码
004:专票、
007:普票、
026:电子发票
81:全电专
82:全电普
85 纸质专票(全电)
86纸质普票(全电)
qdzzfpzldm否string发票类型代码为85、86时必返回
1130:增值税专用发票(中文三联无金额限制版);
1160:增值税专用发票(中文六联无金额限制版);
04:2016版增值税普通发票(二联折叠票)
05:2016版增值税普通发票(五联折叠票)
kplx是string1开票类型0:正数 1:负数
bbh否string版本号
tspz否string2特殊票种
00:不是
01:农产品销售
02:农产品收购
06:抵扣通行费
07:其它通行费
08:成品油销售
18:成品油红字专票
xhdwdzdh是string300销货单位地址电话
xhdwmc是string300销货单位名称
xhdwsbh是string26销货单位识别号
xhdwyhzh是string200销货银行银行账号
ghdwdzdh否string300购货单位地址电话
ghdwmc是string300购货单位名称
ghdwsbh是string26购货单位识别号
ghdwyhzh否string200购货单位银行帐号
zsfs是string1征税方式 0:普通征税 2:差额征税
kce否string16差额 扣除额zsfs为2时此项必返回
hjje是string16合计金额
hjse是string16合计税额
jshj是string16价税合计
bz否string460备注
skr是string收款人
fhr是string复核人
kpr是string开票人
kpsqr否string开票申请人
yfpdm否string12原发票代码
yfphm否string20原发票号码
ewm否string二维码
url否string电票返回
pdfurl否stringpdf地址(全电返回)
ofdurl否string国税OFD地址(全电返回)
ewmurl否string二维码url(全电返回)
xmlurl否stringxml数据下载地址(全电返回)
yqjg是string10验签结果
fyxm是object[]费用项目 详见:3.1、返回参数(fyxm数据信息)
zfrq否string作废日期 格式YYYYMMDDHHMMSS
zfr否string作废人
sjh否string11手机号
yx否string40邮箱
djlsh否string200单据流水号
qdbz是string1清单标志
sjly否string数据来源
cwxx否string开具失败对应的错误信息

请求参数

Body 参数application/json
method
string 
固定值djfycx
必需
object
object 
必需
pageNum
integer 
页码
可选
页码 [大小: 1~] 默认为1
pageSize
integer 
每页显示数量
可选
每页显示数量 [大小: 1~5000] 默认为10
request
object 
请求对象
必需
请求对象
示例
{
  "method": "string",
  "object": {
    "pageNum": 0,
    "pageSize": 0,
    "request": {
      "djly": "string",
      "djlsh": "string",
      "ghdwmc": "string",
      "ghdwsbh": "string",
      "bz": "string",
      "kpsqr": "string",
      "djlx": [
        "string"
      ],
      "kplx": "string",
      "djzt": [
        "string"
      ],
      "cfOrHbType": [
        "string"
      ],
      "zsfs": "string",
      "hjjeq": "string",
      "hjjez": "string",
      "hjseq": "string",
      "hjsez": "string",
      "jshjq": "string",
      "jshjz": "string",
      "sqrqq": "string",
      "sqrqz": "string"
    }
  }
}

返回响应

🟢200成功
application/json
Body
code
integer 
返回代码
必需
返回代码
data
object 
返回对象
必需
返回数对象
count
integer 
返回个数
必需
返回个数
dataList
array [object {31}] 
返回数据
必需
返回数据
pageNum
integer 
页码
必需
页码
msg
string 
返回消息
必需
返回消息
示例
{
  "code": 0,
  "data": {
    "count": 1,
    "dataList": [
      {
        "bz": "备注",
        "djlsh": "单据流水号",
        "hblsh": [
          "合并的流水号"
        ],
        "cfOrHbType": "拆分合并标识",
        "djlx": "单据类型",
        "djly": "单据来源",
        "djzt": "单据状态",
        "fhr": "复核人",
        "fyxm": [
          {
            "dj": "单价",
            "dw": "单位",
            "fphxz": "发票行性质",
            "ggxh": "规格型号",
            "hsbz": "含税标志",
            "je": "金额",
            "lslbs": "零税率标识",
            "se": "税额",
            "sl": "税率",
            "spbc": "商品别称",
            "spbm": "商品编码",
            "spmc": "商品名称",
            "spsl": "商品数量",
            "spsm": "商品税目",
            "xh": "序号",
            "yhzcbs": "优惠政策标识",
            "zxbm": "自行编码",
            "zzstsgl": "增值税特殊管理"
          }
        ],
        "ghdwdzdh": "购货单位地址电话",
        "ghdwmc": "购货单位名称",
        "ghdwsbh": "购货单位识别号",
        "ghdwyhzh": "购货单位银行帐号",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "kce": "扣除额",
        "kplx": "开票类型",
        "kpr": "开票人",
        "kpsqr": "开票申请人",
        "qdbz": "清单标志",
        "sjh": "手机号",
        "skr": "收款人",
        "sqrq": "申请日期",
        "xhdwdzdh": "销货单位地址电话",
        "xhdwmc": "销货单位名称",
        "xhdwsbh": "销货单位识别号",
        "xhdwyhzh": "销货银行银行账号",
        "yx": "邮箱",
        "zsfs": "征税方式",
        "hbbs": "合并标识",
        "gmfdz": "数电-地址",
        "gmflxdh": "数电-电话",
        "gmfkhh": "数电-开户行",
        "gmfyhzh": "数电-银行账号",
        "xhdwdz": "销方地址",
        "xhdwdh": "销方电话",
        "xhdwkhh": "销方开户行",
        "xhdwzh": "销方账户",
        "fp": [
          {
            "fpdm": "发票代码",
            "fphm": "发票号码",
            "kprq": "开票日期",
            "fpzt": "发票状态",
            "fplxdm": "发票类型代码",
            "qdzzfpzldm": "全电纸质发票种类代码",
            "kplx": "开票类型",
            "tspz": "特殊票种",
            "xhdwsbh": "销货单位识别号",
            "xhdwmc": "销货单位名称",
            "xhdwdzdh": "销货单位地址电话",
            "xhdwyhzh": "销货银行银行账号",
            "ghdwsbh": "购货单位识别号",
            "ghdwmc": "购货单位名称",
            "ghdwdzdh": "购货单位地址电话",
            "ghdwyhzh": "购货单位银行帐号",
            "zsfs": "征税方式",
            "hjje": "合计金额",
            "hjse": "合计税额",
            "jshj": "价税合计",
            "bz": "备注",
            "skr": "收款人",
            "fhr": "复核人",
            "kpr": "开票人",
            "kpsqr": "开票申请人",
            "spsm": "商品税目",
            "qdbz": "清单标志",
            "ewm": "二维码",
            "pdfurl": "pdf地址",
            "url": "电票返回",
            "ofdurl": "国税OFD地址",
            "ewmurl": "二维码url",
            "xmlurl": "xml数据下载地址",
            "yqjg": "验签结果",
            "sjh": "手机号",
            "yx": "邮箱",
            "djlsh": "单据流水号",
            "sjly": "数据来源",
            "fyxm": [
              {
                "fphxz": "发票行性质",
                "spmc": "商品名称",
                "spsm": "商品税目",
                "ggxh": "规格型号",
                "dw": "单位",
                "spsl": "商品数量",
                "dj": "单价",
                "je": "金额",
                "sl": "税率",
                "se": "税额",
                "hsbz": "含税标志",
                "spbm": "商品编码",
                "zxbm": "自行编码",
                "yhzcbs": "优惠政策标识",
                "lslbs": "免税类型",
                "zzstsgl": "增值税特殊管理"
              }
            ]
          }
        ]
      }
    ],
    "pageNum": 1
  },
  "msg": "成功"
}
上一页
批量单据导入
下一页
账号注册
Built with