批量待开导入

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
tdywList	否	Object[]		特定业务信息数组，详细内容请见2.1
requestList	是	Object[]		请求数据数组
dklsh	是	String		待开流水号,用于区分商品是否打印到同一张发票中相同流水号，表示打印在同一张发票
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代表负票。
yfpdm	否	String	12	当开票类型为1时，发票类型为：004、007、026、85、86必填
yfphm	否	String	20	当开票类型为1时，发票类型为：004、007、026、85、86必填
ysdfphm	否	String	20	当开票类型为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	否	String	1	当开票类型为1时必填可填代码 1:销货退回、 2:开票有误、 3:服务终止、 4:销售折让
zsfs	是	String	1	征税方式： 0:普通征收， 2:差额征收，不填：默认为0
kce	否	String	16	差额征税扣除额：征收方式为2时必填，长度限制16，不能大于价税合计
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）
lzmxxh	否	String		蓝字发票序号（数电待开红字确认单冲红使用）开票类型为1，81：数电专、82：数电普、85：纸质专票（数电）、86：纸质普票（数电）申请红字确认单时使用

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

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时：红字信息表编号不能为空
销方的地址电话不存在系统中
销方的开户行及账户不存在系统中
免税类型不正确
优惠政策不正确
手机号格式不正确
邮箱格式不正确

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

1、接口及场景描述#

2、请求参数#

2.1、特定业务信息#

3、返回参数#

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

请求参数

返回响应

1、接口及场景描述

2、请求参数

2.1、特定业务信息

3、返回参数

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