批量单据导入

1、接口及场景描述

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

2、请求参数

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

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": "",
                "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": ""
            }
        ]
    }
}

1、接口及场景描述#

2、请求参数#

3、返回参数#

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

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数

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