税局维护、停机消息推送接口说明

POST

/服务商CallbackURL地址

结果回调

💡

注意：忽略上面api.qixiangyun.com云南百望云的域名，这个接口文档是客户提供给云南百望云的回调接口说明！！！

本接口需要客户自行设计实现，发布后把接口访问地址发给云南百望云，云南百望云进行配置，将税局维护、停机消息调用此接口通知到客户。
调用方式: HTTP POST。
报文格式：application/json; utf-8。

请求参数

Body 参数application/json

noticeType

string

通知类型

必需

10：平台维护通知；
20：税局维护通知；
30：税局异常通知；
31：税局恢复通知；
40：查验异常通知；
41：查验恢复通知；
目前仅支持“20：税局维护通知”

extend

object

额外信息

必需

该通知的更多信息

title

string

税局通知标题

必需

publish_time

string

发布时间

必需

area

integer

地区代码

必需

地区代码对照表：https://apifox.com/apidoc/shared-e9b09352-8c2d-44ea-a052-aa5f1843be55/doc-4135405

contentType

string

内容类型名称

必需

msg

string

通知内容

必需

通知的具体内容

示例

{
  "noticeType": "20",
  "extend": {
    "title": "国家税务总局黑龙江省税务局关于增值税发票管理系统停机升级的通知",
    "publish_time": "2024年4月28日",
    "area": 2300,
    "contentType": "维护"
  },
  "msg": "尊敬的纳税人：\n        为完善、优化增值税发票管理系统相关功能，按照国家税务总局工作安排，我局定于2024年4月28日18:00至22:00对增值税发票管理系统进行停机升级。       \n        在此期间，部分网上涉税业务暂停使用，具体包括但不限于以下业务：机动车销售统一发票开具、增值税发票在线开具上传、远程抄报税、红字信息表申请、发票勾选确认、发票查验等。       \n        请您根据情况提前做好准备，由此带来的不便，敬请谅解。                                                                                  国家税务总局黑龙江省税务局                                                                                   2024年4月28日"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/服务商CallbackURL地址' \
--header 'Content-Type: application/json' \
--data-raw '{
    "noticeType": "20",
    "extend": {
        "title": "国家税务总局黑龙江省税务局关于增值税发票管理系统停机升级的通知",
        "publish_time": "2024年4月28日",
        "area": 2300,
        "contentType": "维护"
    },
    "msg": "尊敬的纳税人：\n        为完善、优化增值税发票管理系统相关功能，按照国家税务总局工作安排，我局定于2024年4月28日18:00至22:00对增值税发票管理系统进行停机升级。       \n        在此期间，部分网上涉税业务暂停使用，具体包括但不限于以下业务：机动车销售统一发票开具、增值税发票在线开具上传、远程抄报税、红字信息表申请、发票勾选确认、发票查验等。       \n        请您根据情况提前做好准备，由此带来的不便，敬请谅解。                                                                                  国家税务总局黑龙江省税务局                                                                                   2024年4月28日"
}'

返回响应

🟢200成功

application/json

Body

code

string

回调返回结果

必需

默认2000为成功，9999为失败

msg

string

成功或失败原因

必需

具体原因

示例

{
  "code": "2000",
  "msg": "成功"
}

修改于 2024-09-07 08:29:45

自然人删除接口

服务异常通知