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

批量单据导入

POST

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
requestList是Object[]请求数据数组
djlsh是String单据流水号保持唯一，流水号重复默认为一条单据，主信息取第一条
sprq是String申请日期,业务的发生日期，格式为:yyyyMMdd
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代表负票。
81-全电专、82-全电普：无法开负数
zsfs是String1征税方式：
0:普通征收，
2:差额征收，
不填：默认为0
kce否String16差额征税扣除额：
征收方式为2时必填，长度限制16，不能大于价税合计
kpsqr否String开票申请人
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）
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:简易征税；折扣行的免税类型与被折扣行一致

3、返回参数#

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

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

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

请求参数

Body 参数application/json
method
string 
固定值pldjdr
必需
sfbqspsj
string 
是否补全商品数据
可选
0：否 1：是 系统会校验填入的商品名称\别称是否可以查询到商品数据，然后再进行数据补齐。不填入默认为0
sfbqgfsj
string 
是否补全购方数据
可选
0：否 1：是 系统会校验填入的购方名称\购方纳税识别号是否可以查询到数据，然后再进行数据补齐。不填入默认为0
sfjygs   
string 
是否校验数据格式
可选
包含必填项，长度，等
0：否
1：是
不填入默认为1
sfjysj
string 
是否校验数值信息
可选
如合计金额、合计税额、价税合计、金额等数据
0：否
1：是
不填入默认为0
requestList
array [object {45}] 
请求数据
必需
djlsh
string 
单据流水号
必需
必填 单据流水号保持唯一，流水号重复默认为一条单据，主信息取第一条
zrrbs
string 
自然人标识
可选
Y: 自然人 N: 非自然人（全电普票可填，其他票种不填）
ghdwmc
string 
购货单位名称
可选
购方名称
ghdwsbh
string 
购货单位识别号
必需
购方纳税识别号
ghdwdzdh
string 
购货单位地址电话
可选
购方地址电话
ghdwyhzh
string 
购货单位银行账户
可选
购货单位银行账户
gmfdz 
string 
数电-地址
可选
数电-地址
gmflxdh 
string 
数电-电话
可选
数电-电话
gmfkhh 
string 
数电-开户行
可选
数电-开户行
gmfyhzh 
string 
数电-银行账号
可选
数电-银行账号
xhdwdz
string 
销方地址
可选
销方地址
xhdwdh
string 
销方电话
可选
销方电话
xhdwkhh
string 
销方开户行
可选
销方开户行
xhdwzh
string 
销方账户
可选
销方账户
fplxdm
string 
发票类型代码
必需
发票类型：
004：专票、
007：普票、
026：电子发票
81：全电专
82：全电普
85 纸质专票(全电)
86纸质普票(全电)
qdzzfpzldm   
string 
数电纸质发票种类代码
可选
发票类型代码为85、86时必传
1130:增值税专用发票（中文三联无金额限制版）;
1160:增值税专用发票（中文六联无金额限制版）；
04:2016版增值税普通发票（二联折叠票）
05:2016版增值税普通发票（五联折叠票）
yx
string 
推送邮箱
可选
推送邮箱
sjh
string 
手机号
可选
推送手机号
kplx
string 
开票类型
必需
开票类型：0代表正票，1代表负票。（81-全电专、82-全电普：无法开负数）
zsfs
string 
征税方式
可选
征税方式：0:普通征收，2:差额征收，不填：默认为0
kce
string 
差额征税扣除额
可选
差额征税扣除额：征收方式为2时必填，长度限制16，不能大于价税合计
skr
string 
收款人
可选
收款人名称
fhr
string 
复核人
可选
复核人名称
kpr
string 
开票人
可选
开票人名称
hsbz
string 
含税标志
必需
是否含税：0:不含税，1:含税（不填：默认为0）；折扣行的是否含税与被折扣行一致；征收方式为2时必为0
hjje
string 
合计金额
可选
合计金额
hjse
string 
合计税额
可选
合计税额
jshj
string 
价税合计
可选
价税合计：征收方式为2时必填
bz
string 
备注
必需
备注
fphxz
string 
发票行性质
必需
发票行性质：0-正常行、1-折扣行、2-被折扣行（选择1，上面一行必须是2）
spbc
string 
商品别名
可选
商品别名
spbm
string 
商品编码
可选
税收编码
spjc
string 
税收编码简称
可选
税收编码简称
spmc
string 
商品名称
可选
商品名称
ggxh
string 
规格型号
可选
规格型号
dw
string 
计量单位
可选
计量单位
spsl
string 
商品数量
必需
数量：必填且不能等于0，整数位不能超过14位，小数点位数最长9位；折扣行数量为空，即使存在数据也不获取；征收方式为2时非必填，数量=金额/单价
dj
string 
单价
可选
单价：非必填，误差正负0.01，整数位不能超过14位，小数位不超过9位，依据数量和金额反算出单价 单价=金额/数量；折扣行金额为空，即使存在数据也不获取；征收方式为2时非必填
je
string 
金额
必需
金额：必填，小数点后2位；折扣行金额应为负数，且不能大于被折扣金额；征收方式为2时非必填，公式：价税合计-税额
sl
string 
税率
必需
税率：必填，小数点后3位，范围0~1之间的数值；折扣行的税率应与被折扣行一致
se
string 
税额
可选
税额：普通征收：税额=金额（不含税）*税率；差额征收：税额=（价税合计-扣除额）/（1+税率）*税率
yhzcbs
string 
优惠政策标识
可选
优惠政策：非必填，不填直接从系统中获取，0:不使用优惠政策，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
string 
免税类型
可选
免税类型：非必填，不填直接从系统中获取，0:正常税率，1:出口免税和其他免税优惠政策（免税），2:不征增值税（不征税），3:普通零税率（0%），4:减按，5:简易征税；折扣行的免税类型与被折扣行一致
sprq
string 
申请日期
必需
必填 业务的发生日期，格式为:yyyyMMdd
kpsqr
string 
开票申请人
可选
开票申请人
示例
{
  "method": "pldjdr",
  "object": {
    "sfbqspsj": "0",
    "sfbqgfsj": "0",
    "sfjygs": "0",
    "sfjysj": "0",
    "requestList": [
      {
        "djlsh": "11111",
        "sprq": "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": "",
        "ykprq": "",
        "tzdbh": "",
        "chyydm": "",
        "zsfs": "0",
        "kce": "",
        "skr": "",
        "fhr": "",
        "kpr": "",
        "hsbz": "",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "bz": "",
        "fphxz": "0",
        "spbc": "",
        "spbm": "",
        "spjc": "",
        "spmc": "香蕉",
        "ggxh": "",
        "dw": "",
        "spsl": "1",
        "dj": "",
        "je": "5",
        "sl": "0.03",
        "se": "",
        "yhzcbs": "",
        "lslbs": ""
      },
      {
        "djlsh": "11111",
        "sprq": "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": "",
        "ykprq": "",
        "tzdbh": "",
        "chyydm": "",
        "zsfs": "0",
        "kce": "",
        "skr": "",
        "fhr": "",
        "kpr": "",
        "hsbz": "",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "bz": "",
        "fphxz": "0",
        "spbc": "",
        "spbm": "",
        "spjc": "",
        "spmc": "香蕉",
        "ggxh": "",
        "dw": "",
        "spsl": "1",
        "dj": "",
        "je": "5",
        "sl": "0.03",
        "se": "",
        "yhzcbs": "",
        "lslbs": ""
      }
    ]
  }
}

返回响应

🟢200成功
application/json
Body
code
integer 
必需
msg
string 
必需
data
object 
必需
success
integer 
必需
failure
integer 
必需
failureInfo
array [object {53}] 
必需
示例
{
  "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": "",
        "djlsh": "20230114",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "yfpdm": "",
        "yfphm": "",
        "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": "",
        "djlsh": "20230114",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "yfpdm": "",
        "yfphm": "",
        "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