税务数字化管理平台
  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