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

批量待开导入

POST
OperationId：pldkdr

1、接口及场景描述#

接口描述： 为企业提供批量导入待开数据功能
是否支持数电及税控发票：全部支持
场景描述：当进行批量导入数据的时候,如导入存在错误数据时,系统会将原数据返回,并增加cwxx(错误信息一列)展示具体的错误信息,用户可将数据进行修改,重新进行数据导入

2、请求参数#

字段名称必选类型长度字段含义及备注
method是String请求方法名
object是Object请求数据
sfbqspsj否String1是否补全商品数据
0：否
1：是
系统会校验填入的商品名称\别称是否可以查询到商品数据，然后再进行数据补齐。不填入默认为0
sfbqgfsj否String1是否补全购方数据
0：否
1：是
系统会校验填入的购方名称\购方纳税识别号是否可以查询到数据，然后再进行数据补齐。不填入默认为0
sfjygs否String1是否校验数据格式(包含必填项，长度，等)
0：否
1：是
不填入默认为1
sfjysj否String1是否校验数值信息(如合计金额、合计税额、价税合计、金额等数据)
0：否
1：是
不填入默认为0
tdywList否Object[]特定业务信息数组，详细内容请见2.1
requestList是Object[]请求数据数组
dklsh是String待开流水号,用于区分商品是否打印到同一张发票中
相同流水号，表示打印在同一张发票
zrrbs否String1全电票必填，其他票种不填
Y: 自然人
N: 非自然人
ghdwmc是String300购方名称
ghdwsbh否String26购方纳税识别号
ghdwdzdh否String300购方地址电话
ghdwyhzh否String200购方开户行及账号
gmfdz否string300数电-地址
gmflxdh否string60数电-电话
gmfkhh否string120数电-开户行
gmfyhzh否string100数电-银行账号
xhdwdz否String300销方地址
xhdwdh否String60销方电话
xhdwkhh否String120销方开户行
xhdwzh否String100销方账户
fplxdm是string2发票类型代码
004：专票、
007：普票、
026：电子发票
81：全电专
82：全电普
85 纸质专票(全电)
86纸质普票(全电)
qdzzfpzldm否string发票类型代码为85、86时必传
1130:增值税专用发票（中文三联无金额限制版）;
1160:增值税专用发票（中文六联无金额限制版）；
04:2016版增值税普通发票（二联折叠票）
05:2016版增值税普通发票（五联折叠票）
yx否String40推送邮箱
sjh否String11手机号
kplx是String1开票类型：
0代表正票，
1代表负票。
yfpdm否String12当开票类型为1时，发票类型为：004、007、026、85、86必填
yfphm否String20当开票类型为1时，发票类型为：004、007、026、85、86必填
ysdfphm否String20当开票类型为1时，发票类型为：81、82、85、86必填
ykprq否String当开票类型为1，必填
其中发票类型为：004、007、026格式为yyyyMMdd；
发票类型为81、82、85、86格式为yyyy-MM-dd HH:mm:ss
tzdbh否String当开票类型为1时，发票类型为：004必填专票时必填
chyydm否String1当开票类型为1时必填
可填代码
1:销货退回、
2:开票有误、
3:服务终止、
4:销售折让
zsfs是String1征税方式：
0:普通征收，
2:差额征收，
不填：默认为0
kce否String16差额征税扣除额：
征收方式为2时必填，长度限制16，不能大于价税合计
skr否String收款人名称
fhr否String复核人名称
kpr否String开票人名称
hsbz是String1是否含税：
0:不含税，
1:含税（不填：默认为0）
折扣行的是否含税与被折扣行一致；征收方式为2时必为0
hjje否String16合计金额
hjse否String16合计税额
jshj否String16价税合计：征收方式为2时必填
bz否String460备注
fphxz是String1发票行性质：
0-正常行、
1-折扣行、
2-被折扣行（选择1，上面一行必须是2）
lzmxxh否String蓝字发票序号 （数电待开红字确认单冲红使用）
开票类型为1，81：数电专、82：数电普、85：纸质专票（数电）、86：纸质普票（数电）申请红字确认单时使用
spbc否String600商品别名
spbm否String19税收编码
spjc否String100税收编码简称
spmc否String600商品名称
ggxh否String40规格型号
dw否String300单位
spsl是String16商品数量：必填且不能等于0，整数位不能超过14位，
小数点位数最长9位；
折扣行数量为空，即使存在数据也不获取；
征收方式为2时非必填，数量=金额/单价
dj否String16单价：非必填，误差正负0.01，
整数位不能超过14位，
小数位不超过9位，依据数量和金额反算出单价
单价=金额/数量；
折扣行金额为空，即使存在数据也不获取；
征收方式为2时非必填
je是String16金额：必填，小数点后2位；
折扣行金额应为负数，且不能大于被折扣金额；
征收方式为2时非必填，公式：价税合计-税额
sl是String8税率：必填，小数点后3位，
范围0~1之间的数值；
折扣行的税率应与被折扣行一致
se否String16税额：普通征收：税额=金额（不含税）*税率；
差额征收：税额=（价税合计-扣除额）/（1+税率）*税率
yhzcbs否String2优惠政策：非必填，不填直接从系统中获取，
空:不使用优惠政策，
1:不征税，
2:免税，
3:按5%简易征收减按1.5%计征，
4:按3%简易征收，
5:按5%简易征收，
6:简易征收，
7:先征后退，
8:100%先征后退，
9:50%先征后退，
10:即征即退30%，
11:即征即退50%，
12:即征即退70%，
13:即征即退100%，
14:超税负3%即征即退，
15:稀土产品，
16:超税负8%即征即退，
17:超税负12%即征即退；折扣行的优惠政策与被折扣行一致
lslbs否String1免税类型：非必填，不填直接从系统中获取，
空:正常税率，
1:出口免税和其他免税优惠政策（免税），
2:不征增值税（不征税），
3:普通零税率（0%），
4:减按，
5:简易征税；折扣行的免税类型与被折扣行一致
tdyslxdm否String特定业务类型 可填写：
建筑服务，
不动产销售服务，
不动产经营租赁服务，
旅客运输服务，
货物运输服务
mtzlDm否string煤炭种类代码选择1020101000000000000、
1020102000000000000、
1020199000000000000商品时，需要选择“煤炭种类”
1. 0100 政府保障煤
2.长协煤(在以下选出)
2.1 0201 协议期不足半年
2.2 0202 协议期在半年至一年期间
2.3 0203 协议期在一年至两年之间
2.4 0204 协议期在两年以上
3. 0300 市场煤
mtpzxxMqkmtfrl否string煤炭品质信息选择1020101000000000000、
1020102000000000000、
1020199000000000000
商品开具不含税金额大于等于一千万时，须填写煤炭品质信息
每千克煤炭发热量（千卡）
mtpzxxGjql否string煤炭品质信息选择1020101000000000000、
1020102000000000000、
1020199000000000000
商品开具不含税金额大于等于一千万时，须填写煤炭品质信息
干基全硫（%）,保留两位小数
mtpzxxGzwhjhff否string煤炭品质信息选择1020101000000000000、
1020102000000000000、
1020199000000000000
商品开具不含税金额大于等于一千万时，须填写煤炭品质信息
干燥无灰基挥发分（%）,保留两位小数

2.1、特定业务信息#

字段名称必选类型长度字段含义及备注
djlsh否string待开流水号，和主信息关联使用 tdyslxdm 不为空时，此值必填
tdywxx否object特定业务信息特定要素类型代码不为空时必填
货物运输服务特定信息
hwysfw否object[]货物运输服务
└ ddd否string80到达地货物运输服务必传按行政区划名称填写，包括县（市、区）名称，
可在县（市、区）后自主增添具体地址
└ qyd否string80起运地货物运输服务必传按行政区划名称填写，包括县（市、区）名称，
可在县（市、区）后自主增添具体地址
└ ysgjhp否string40运输工具号牌货物运输服务必传运输工具种类属于无牌号的工具种类时，需填写无
└ ysgjzl否string4运输工具种类货物运输服务必传
（铁路运输、公路运输、水路运输、航空运输、管道运输）
└ yshwmc否string80运输货物名称货物运输服务必传
建筑服务特定信息
jzfw否object建筑服务
└ jzfwfsd否string120建筑服务发生地,建筑服务必填
└ fsdxxdz否string120发生地详细地址
└ jzxmmc否string80建筑项目名称,建筑服务必填
└ kdsbz否string1跨地市标志,建筑服务必填Y/N
└ kqysssxbgglbm否string跨区域涉税事项报验管理编码，仅限于跨地（市）标志为是时，必填
└ tdzzsxmbh否string50土地增值税项目编号
不动产服务特定信息
bdcfwList否object[]不动产服务集合
fwcqzshm否string40不动产经营租赁服务必传，不动产销售服务选填
bdcdz否string120不动产地址,不动产服务必传
bdcxxdz否string120不动产详细地址
zlqq否string租赁期起,不动产经营租赁服务必传格式：yyyyMMdd
zlqz否string租赁期止,不动产经营租赁服务必传格式：yyyyMMdd
kdsbz否string1跨地市标志,不动产服务必传Y/N
mjdw否string4面积单位,
不动产服务必传平方米,亩,m²,平方千米,公顷,hm²,km²
wqhtbabh否string28网签合同备案编号.
不动产销售服务必传
tdzzsxmbh否string18土地增值税项目编号.
不动产销售服务必传
hdjsjg否string16核定计税价格.
不动产销售服务必传
sjcjhsje否string16实际成交含税金额.
不动产销售服务必传
xzqhszDm是string16行政区划数字代码.
不动产销售、不动产租赁必填
旅客运输服务特定信息
lkysfw否object[]旅客运输服务
└ cxr否string20出行人
└ cxrzjlx否string3出行人证件类型，旅客运输服务必传同经办人证件种类代码。
└ cxrzjhm否string20出行人证件号码
└ cxrq否string出行日期,旅客运输服务必传格式：yyyy-MM-dd
└ cfd否string80出发地,旅客运输服务必传按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
└ ddd否string80到达地旅客运输服务必传按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
└ jtgjlx否string1交通工具类型旅客运输服务必传
"1":飞机;
"2":火车;
"3":长途汽车;
"4":公共交通;
"5":出租车;
"6":汽车;
"7":船舶;
"9":其他
└ dengj否string20等级,若交通工具为
火车、飞机、船舶，
则该要素为必填；
等级类型: (交通工具-飞机:经济舱、头等舱、公务舱),
(交通工具-船舶:一等舱、二等舱、三等舱),
(交通工具-火车:一等座、二等座、软席(软座、软卧)、硬席(硬座、硬卧))

3、返回参数#

code为0时，代表全部成功
code为30002时，代表存在错误数据
字段名称是否必返回类型长度字段含义及备注
code是integer返回code码
msg是string返回信息
data是integer返回数据
success是integer成功数量
failure是string失败数量
failureInfo否array存在错误数据的数据数组

4、返回错误信息示例（code统一为30002）#

cwxx(错误信息)
折扣行与被折扣行需成对出现，且被折扣在折扣行上面
折扣行和被折扣行商品名称必须一致
折扣行的是否含税与被折扣行一致
折扣行与被折扣行的优惠政策不一致
折扣行与被折扣行的免税类型不一致
折扣行,被折扣行商品编码必须相同
折扣行的税率应与被折扣行一致
折扣行与被折扣行需成对出现，且被折扣在折扣行上面
折扣行的金额,必须为负数
折扣行金额不允许大于被折扣行金额
商品数量不可为空
商品数量不能出现特殊字符
商品数量不能超过小数点位数18位
商品数量整数不能超过14位
商品单价不能出现特殊字符
商品单价不能超过小数点位数18位
商品单价整数不能超过14位
金额不可为空
商品金额不能出现特殊字符
商品金额不能超过小数点位数2位
数量*单价不等于金额
商品税率不能出现特殊字符
税率不可为空
商品税率不能超过小数点位数3位
商品税率不能大于1
金额*税率不等于税额
商品别称和商品名称必填其中一个
根据商品别称未查询到指定的商品信息
不存在此税收编码
根据商品名称未查询到指定的商品信息
超限额不允许导入
当前单据的合计金额是xxx"，商品明细的合计金额是xxx
当前单据的合计税额是xxx"，商品明细的合计税额是xxx
当前单据的价税合计是xxx"，商品明细的价税合计是xxx
购方名称不可为空
发票类型不可为空
发票类型不正确
开票类型不可为空
征收方式为差额征收时仅能有一个商品
征收方式为差额征收时，扣除额不可为空
征收方式为差额征收时，价税合计不可为空
征收方式为差额征收时，扣除额不能大于价税合计
征收方式为差额征收时，是否含税必为0
负数发票不存在折扣行
开票类型为1时,原发票代码不可为空
开票类型为1时,原发票号码不可为空
开票类型为1时,原开票日期为空
开票类型为1时：红字信息表编号不能为空
销方的地址电话不存在系统中
销方的开户行及账户不存在系统中
免税类型不正确
优惠政策不正确
手机号格式不正确
邮箱格式不正确

请求参数

Body 参数application/json

示例
{
    "method": "pldkdr",
    "object": {
        "sfbqspsj": "0",
        "sfbqgfsj": "0",
        "sfjygs": "0",
        "sfjysj": "0",
        "tdywList": [
            {
                "dklsh": "",
                "tdyw": {
                    "jzfw": {
                        "jzfwfsd": "",
                        "fsdxxdz": "",
                        "jzxmmc": "",
                        "kdsbz": "",
                        "tdzzsxmbh": ""
                    },
                   "bdcfwList": [
                        {
                        "fwcqzshm": "",
                        "bdcdz": "",
                        "bdcxxdz": "",
                        "zlqq": "",
                        "zlqz": "",
                        "kdsbz": "",
                        "mjdw": "",
                        "wqhtbabh": "",
                        "tdzzsxmbh": "",
                        "hdjsjg": "",
                        "sjcjhsje": "",
                        "xzqhszDm": ""
                        }
                    ],    
                    "lkysfw": [
                        {
                            "cxr": "",
                            "cxrzjlx": "",
                            "cxrzjhm": "",
                            "cxrq": "",
                            "cfd": "",
                            "ddd": "",
                            "jtgjlx": "",
                            "dengj": ""
                        }
                    ],
                    "hwysfw": [
                        {
                            "ddd": "",
                            "qyd": "",
                            "ysgjhp": "",
                            "ysgjzl": "",
                            "yshwmc": ""
                        }
                    ]
                }
            }
        ],
        "requestList": [
            {
                "dklsh": "20230114",
                "zrrbs": "",
                "ghdwmc": "天机百望有限公司",
                "ghdwsbh": "91500000747150337A",
                "ghdwdzdh": "",
                "ghdwyhzh": "",
                "xhdwdz": "天津武清开发区泉州路19号",
                "xhdwdh": "022-82125068",
                "xhdwkhh": "汇丰银行(中国)有限公司天津分行",
                "xhdwzh": "625032354011",
                "kpzt": "",
                "fply": "",
                "fplxdm": "007",
                "qdzzfpzldm": "",
                "yx": "",
                "sjh": "",
                "kplx": "",
                "yfpdm": "",
                "yfphm": "",
                "ysdfphm": "",
                "ykprq": "",
                "tzdbh": "",
                "chyydm": "",
                "zsfs": "0",
                "kce": "",
                "skr": "",
                "fhr": "",
                "kpr": "",
                "hsbz": "",
                "hjje": "",
                "hjse": "",
                "jshj": "",
                "bz": "",
                "fphxz": "0",
                "lzmxxh": "",
                "spbc": "",
                "spbm": "",
                "spjc": "",
                "spmc": "香蕉",
                "ggxh": "",
                "dw": "",
                "spsl": "1",
                "dj": "",
                "je": "5",
                "sl": "0.03",
                "se": "",
                "yhzcbs": "",
                "lslbs": "",
                "tdyslxdm": ""
            }
        ]
    }
}

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 30002,
    "msg": "成功0笔，失败2笔",
    "data": {
        "success": 0,
        "failure": 2,
        "failureInfo": [
            {
                "ids": null,
                "ghdwsbh": "91500000747150337A",
                "ghdwmc": "天机百望有限公司",
                "ghdwdzdh": "",
                "ghdwyhzh": "",
                "xhdwdzdh": "天津武清开发区泉州路19号~022-82125068",
                "xhdwyhzh": "汇丰银行(中国)有限公司天津分行~625032354011",
                "xhdwdz": "天津武清开发区泉州路19号",
                "xhdwdh": "022-82125068",
                "xhdwkhh": "汇丰银行(中国)有限公司天津分行",
                "xhdwzh": "625032354011",
                "zrrbs": "",
                "kpzt": "",
                "zsfs": "0",
                "kce": "",
                "fplxdm": "007",
                "kplx": "",
                "skr": "",
                "fhr": "",
                "kpr": "",
                "bz": "",
                "dklsh": "20230114",
                "hjje": "",
                "hjse": "",
                "jshj": "",
                "yfpdm": "",
                "yfphm": "",
                "ysdfphm": "",
                "ykprq": "",
                "tzdbh": "",
                "chyydm": "",
                "fply": "",
                "yx": "",
                "sjh": "",
                "xh": "0",
                "fphxz": "0",
                "spbc": "",
                "spmc": "香蕉",
                "spsm": "",
                "ggxh": "",
                "dw": "",
                "spsl": "1",
                "dj": "",
                "je": "5",
                "sl": "0.03",
                "se": "",
                "hsbz": "",
                "spbm": "",
                "spjc": "",
                "zxbm": "",
                "yhzcbs": "",
                "lslbs": "",
                "zzstsgl": null,
                "cwxx": "开票类型不可为空"
            },
            {
                "ids": null,
                "ghdwsbh": "91500000747150337A",
                "ghdwmc": "天机百望有限公司",
                "ghdwdzdh": "",
                "ghdwyhzh": "",
                "xhdwdzdh": null,
                "xhdwyhzh": null,
                "xhdwdz": "天津武清开发区泉州路19号",
                "xhdwdh": "022-82125068",
                "xhdwkhh": "汇丰银行(中国)有限公司天津分行",
                "xhdwzh": "625032354011",
                "zrrbs": "",
                "kpzt": "",
                "zsfs": "0",
                "kce": "",
                "fplxdm": "007",
                "kplx": "",
                "skr": "",
                "fhr": "",
                "kpr": "",
                "bz": "",
                "dklsh": "20230114",
                "hjje": "",
                "hjse": "",
                "jshj": "",
                "yfpdm": "",
                "yfphm": "",
                "ysdfphm": "",
                "ykprq": "",
                "tzdbh": "",
                "chyydm": "",
                "fply": "",
                "yx": "",
                "sjh": "",
                "xh": "1",
                "fphxz": "0",
                "spbc": "",
                "spmc": "香蕉",
                "spsm": "",
                "ggxh": "",
                "dw": "",
                "spsl": "1",
                "dj": "",
                "je": "5",
                "sl": "0.03",
                "se": "",
                "hsbz": "",
                "spbm": "",
                "spjc": "",
                "zxbm": "",
                "yhzcbs": "",
                "lslbs": "",
                "zzstsgl": null,
                "cwxx": ""
            }
        ]
    }
}
上一页
客户导入
下一页
待开分页查询
Built with