# 进项-抵扣认证全流程-电子税局版

修改历史

版本号	变更日期	变更内容	变更人	对接疑问联系方式
V1.00	2022-07-30	创建	祖凯	zukai@yonyou.com

# 对接流程

待补充

注意事项：

操作类型接口需保证操作税号已通过税务云登录电子税局：勾选、撤销勾选、确认认证、取消认证等
抵扣认证流程基于税局的认证流程，相对复杂，且在不同的报税期表现有所区别，请对接技术人员、业务人员可自行对认证相关的税务常识进行必要性扫盲和了解

# 1、电子税局登录信息（验证码）获取

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/send-etax-smscode?appid=XXXX

# 请求体

{
    "username":"xxxx",
    "phone":"xxxx",
    "password":"123456",
    "userType":"",
    "nsrsbh": "91110000600001760P",
    "orgcode":""
}

# 请求体说明

参数	类型	是否必填	默认值	描述	说明
username	String	是		电子税局-用户名
phone	String	否		电子税局-手机号
password	String	是		电子税局-密码
userType	String	否	0	电子税局-用户类型,没有填空
nsrsbh	String	是		纳税人识别号	不能同时为空

# 返回值

{
	"code": "0000",
    "datas":0,
	"msg":"验证码已发送成功，请查收!"
}
{
	"code": "0000",
    "datas":1,
	"msg":"当前税号已登录，直接跳转登录!"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功; 其他-操作失败
msg	String	信息说明
datas	String	返回结果	0-短信已发送成功；1-登录信息未过期，无须登录，不发短信，可直接业务操作.

# 2、电子税局登录-登录

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/etax-login?appid=XXXX

# 请求体

{
    "username":"xxxx",
    "phone":"xxxx",
    "password":"123456",
    "userType":"",
    "nsrsbh": "91110000600001760P",
    "verifyCode": "123435",
    "orgcode":""
}

# 请求体说明

参数	类型	是否必填	默认值	描述	说明
username	String	是		电子税局-用户名	短信验证登录如过未指定用户名，请填手机号
phone	String	否		电子税局-手机号
verifyCode	String	否		电子税局-验证码
password	String	是		电子税局-密码	yyyyMMdd格式
userType	Number	否	0	电子税局-用户类型
nsrsbh	String	是		纳税人识别号	与orgcode不能同时为空

# 登录参数说明

登录方式分为：账号密码登录 、 短信验证登录。
对应的省份为:
账号密码登录：广东省
短信验证登录：上海省、内蒙古
账号密码登录必填参数：username password nsrsbh
短信验证登录必填参数：username password nsrsbh phone verifyCode

# 返回值

{
	"code": "0000",
    "datas":null,
	"msg":"操作成功"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功;
msg	String	信息说明

# 3、发票勾选(抵扣+不抵扣) `[登录信息未过期]`

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/gxtj?appid=XXXX

# 请求体

{
    "hmdms": [
        {
            "fpDm": "3100111130",
            "fpHm": "11404542",
            "kprq": "20170831",
            "undeductReason" : 1
        }
    ],
    "deductMode": 1,
    "mobileOrEmail":"17090028043",
    "nsrsbh": "91110000600001760P",
    "orgcode":""
}

# 请求体说明

参数	类型	是否必填	描述	说明
hmDms	List	是	发票列表
- fpDm	String	是	发票代码
- fpHm	String	是	发票号码
- kprq	String	是	开票日期	yyyyMMdd格式
- undeductReason	Integer	否	不抵扣原因，不抵扣勾选-必填	1-用于非应税项目 2-用于免税项目 3-用于集体福利和个人消费 4-非正常损失 5-其他
nsrsbh	String	否	纳税人识别号	与orgcode不能同时为空
orgcode	String	否	组织机构编码	与nsrsbh不能同时为空
deductMode	Number	否	抵扣类型	抵扣类型 1.抵扣(默认） 2.不抵扣
mobileOrEmail	String	否	勾选人信息	勾选人再税务云的手机或邮箱

# 返回值

{
	"code": "0000",
    "datas":{
        "hmdms":[{
            "fpDm":"fpDm",
            "fpHm":"fpHm"
        }]
    },
	"msg":"操作成功"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功;
msg	String	信息说明
datas	Object	数据体
- hmdms	Array	申请错误的发票	全部成功提交税局，返回空数组或null，请自行适配

# 4、撤销勾选(抵扣+不抵扣) `[登录信息未过期]`

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/cxgx?appid=XXXX

# 请求体

{
    "hmdms": [
        {
            "fpDm": "3100111130",
            "fpHm": "11404542",
            "kprq": "20170831"
        }
    ],
    "deductMode": 1,
    "mobileOrEmail":"17090028043",
    "nsrsbh": "91110000600001760P",
    "orgcode":""
}

# 请求体说明

参数	类型	是否必填	描述	说明
hmdms	List	是	发票列表
- fpDm	String	是	发票代码
- fpHm	String	是	发票号码
- kprq	String	是	开票日期	yyyyMMdd格式
nsrsbh	String	否	纳税人识别号	与orgcode不能同时为空
orgcode	String	否	组织机构编码	与nsrsbh不能同时为空
deductMode	Number	否	抵扣类型	抵扣类型 1.抵扣(默认） 2.不抵扣
mobileOrEmail	String	否	勾选人信息	勾选人再税务云的手机或邮箱

# 返回值

{
	"code": "0000",
    "datas":{
        "hmdms":[{
            "fpDm":"fpDm",
            "fpHm":"fpHm"
        }]
    },
	"msg":"操作成功"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功;
msg	String	信息说明
datas	Object	数据体
- hmdms	Array	申请错误的发票	全部成功提交税局，返回空数组或null，请自行适配

# 5、刷新勾选保存结果(发票勾选+撤销勾选) `[登录信息未过期]`

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/etax-sync-gxresult?appid=XXXX

# 请求体

{
    "nsrsbh": "91110000600001760P"
}

# 请求体说明

参数	类型	长度	是否必填	默认值	描述	说明
nsrsbh	String		是		纳税人识别号

# 返回值

{
	"code": "0000",
    "datas":{
    },
	"msg":"操作成功"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功; 操作成功代表触发成功，需要调用”从税务云获取专票“，并关注"taskStatus"字段进行确认操作已完成
msg	String	信息说明
datas	Object	数据体

# 6、电子税局同步待勾选发票 `[登录信息未过期]`

本接口是触发税务云拉取电子税局的发票，本身并不返回数据，调用完成后，需继续调用 从税务云获取专票（非税局，需要先到税务云同步数据） 拉取发票列表。
本接口并非实时拉取，每次登录后，存在预下载时间差。因此实际需要税号登录后一段时间，再调用。
建议通过定时任务调用

# URL

POST url:http://{IP}:{PORT}/invoiceclient-web/api/vat/etax-sync-invoices?appid=XXXX

# 请求体

{
    "nsrsbh": "91110000600001760P"
}

# 请求体说明

参数	类型	长度	是否必填	默认值	描述	说明
nsrsbh	String		是		纳税人识别号

# 返回值

{
	"code": "0000",
    "datas":{
        "hasNext": true,
        "taskNo": "本批次任务号",
        "syncCount": 200
    },
	"msg":"操作成功"
}

# 返回值说明

参数	类型	描述	说明
code	String	状态码	0000-操作成功;
msg	String	信息说明
datas	Array	刷新的任务列表结果
- taskNo	String	本批次任务号
- hasNext	boolean	是否有后续发票	true - 有后续任务，需接续循环；false - 无后续任务，可退出
- syncCount	Integer	本次同步发票数量	单批次最大200

# 7、抵扣认证 - 统计 `[登录信息未过期]`

接口定义同进项-抵扣认证全流程-抵扣认证 - 统计

# 8、抵扣认证 - 查询 `[登录信息未过期]`

接口定义同进项-抵扣认证全流程-抵扣认证 - 查询

# 9、抵扣认证 - 取消 `[登录信息未过期]`

接口定义同进项-抵扣认证全流程-抵扣认证 - 查询

# 10、查询当前税号税期 `[登录信息未过期]`

接口定义同查询当前税号税期-税盘在线

# 11、检测税盘是否在线

接口定义同检测税盘是否在线

# 12、从税务云获取专票

接口定义同从税务云获取专票非税局需要先到税务云同步数据

# 13、附录

# 认证发票类型

code	描述	备注
1	增值税电子普通发票
2	增值税电子专用发票
3	增值税普通发票
4	增值税专用发票
5	机动车销售统一发票
6	货物运输业增值税专用发票
8	增值税电子普通发票(成品油)
9	成品油普通发票(卷式)
10	增值税普通发票(成品油)
11	增值税专用发票(成品油)
12	增值税普通发票(卷式)
14	通行费增值税电子普通发票
15	二手车销售统一发票
17	海关缴款书
24	出口转内销发票
30	出口转内销海关缴款书
31	通用机打发票
32	通用机打电子发票

# 状态码

状态码	说明
0000	操作成功
1001	数据不合法，传入参数
1002	数据不存在
9999	未知错误
5001	当前状态不可认证(时间
5002	当前状态不可取消认证(时间

← 进项-抵扣认证全流程 OFD能力 →

# 进项-抵扣认证全流程-电子税局版

# 对接流程

# 1、电子税局登录信息（验证码）获取

# URL

# 请求体

# 请求体说明

# 返回值

# 返回值说明

# 2、电子税局登录-登录

# URL

# 请求体

# 请求体说明

# 登录参数说明

# 返回值

# 返回值说明

# 3、发票勾选(抵扣+不抵扣) [登录信息未过期]

# URL

# 请求体

# 请求体说明

# 返回值

# 返回值说明

# 4、 撤销勾选(抵扣+不抵扣) [登录信息未过期]

# URL

# 请求体

# 请求体说明

# 返回值

# 返回值说明

# 5、 刷新勾选保存结果(发票勾选+撤销勾选) [登录信息未过期]

# URL

# 请求体

# 请求体说明

# 返回值

# 返回值说明

# 6、 电子税局同步待勾选发票 [登录信息未过期]

# URL

# 请求体

# 请求体说明

# 返回值

# 返回值说明

# 7、 抵扣认证 - 统计 [登录信息未过期]

# 8、 抵扣认证 - 查询 [登录信息未过期]

# 9、 抵扣认证 - 取消 [登录信息未过期]

# 10、查询当前税号税期 [登录信息未过期]

# 11、检测税盘是否在线

# 12、从税务云获取专票

# 13、 附录

# 认证发票类型

# 状态码

# 3、发票勾选(抵扣+不抵扣) `[登录信息未过期]`

# 4、撤销勾选(抵扣+不抵扣) `[登录信息未过期]`

# 5、刷新勾选保存结果(发票勾选+撤销勾选) `[登录信息未过期]`

# 6、电子税局同步待勾选发票 `[登录信息未过期]`

# 7、抵扣认证 - 统计 `[登录信息未过期]`

# 8、抵扣认证 - 查询 `[登录信息未过期]`

# 9、抵扣认证 - 取消 `[登录信息未过期]`

# 10、查询当前税号税期 `[登录信息未过期]`

# 13、附录