海关缴款书勾选

接口描述

该接口用于同步企业电子发票服务平台（发票云）海关缴款书勾选。目前支持抵扣勾选、撤销抵扣勾选、不抵扣勾选、撤销不抵扣勾选。

错误码

错误代码	错误消息	解决方案
600004	未开通权限，请联系管理员！	与运营沟通申请开通对应权限
505002	接口调用异常，请联系管理员!	请联系管理员
FprzNotSupportDq	暂不支持该地区进行发票云认证！
FprzForbiddenOperation	此税号不属于当前appkey对应的企业，不可操作！	检查纳税人识别号与appKey的关系
50001	传入参数不能为空！	请检查入参是否不为空
50002	传入的参数-企业纳税人识别号nsrsbh不能为空！	请检查入参nsrsbh是否不为空
50003	传入的参数-税款所属期skssq不能为空！	请检查入参skssq是否不为空
50004	传入的参数-勾选类型gxlx不能为空！	请检查入参gxlx是否不为空
50005	传入参数中的list数据不能为空	请检查入参list是否不为空
50006	参数list中，海关缴款书号码jkshm不能为空	请检查入参list中jkshm是否不为空
50007	参数list中，填发日期tfrq不能为空	请检查入参list中tfrq是否不为空
50008	参数list中，税款金额se不能为空	请检查入参list中se是否不为空
50009	海关缴款书申请认证失败，请联系管理员!	请联系管理员
50009	海关缴款书出口转内销申请认证失败，请联系管理员!	请联系管理员
8600	当前发票勾选操作发生异常，请联系管理员	请联系管理员
4100	当前勾选类型不支持	请检查gxlx是否在支持的范围内
50013	当前请求参数中不抵扣原因不能为空！	请检查bdkyy是否不为空
50014	不支持当前请求参数中的不抵扣原因！	请检查bdkyy是否在支持的范围内
50015	当不抵扣原因选择-其他时，不抵扣原因描述不能为空！	请检查bdkyyms是否不为空
8600	当前发票勾选操作发生异常，请联系管理员	请联系管理员
FprzSyncToAsync	业务处理超时,本次请求已自动转为异步方式，可通过taskId查询异步结果	可以使用任务转异步返回的参数通过转异步请求结果查询接口查询任务转异步后执行结果。

请求参数

Header 参数

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

nsrsbh

string

企业纳税人识别号

必需

skssq

string <yyyyMM>

税款所属期

必需

gxlx

enum<string>

勾选类型

必需

1-抵扣；2-退税；4-不抵扣；6-撤销抵扣；7-撤销不抵扣；13-撤销退税；

枚举值:

1246713

示例值:

bdkyy

enum<integer>

不抵扣原因

必需

当gxlx=4时不为空，即勾选不抵扣时必填

枚举值:

12345

示例值:

bdkyyms

string

不抵扣原因描述

必需

当gxlx=4并且bdkyy=5时必填

list

array [object {5}]

勾选海关缴款书列表

必需

jkshm、zmbh不可同时为空。

jkshm

string | null

海关缴款书号码

可选

zmbh

string | null

出口转内销证明编号

可选

出口转内销海关缴款书勾选必填

tfrq

string <yyyyMMdd>

填发日期

必需

示例值:

20220711

integer

税款金额

必需

yxse

integer | null

有效税额

可选

accountId

string | null

登录账户唯一标识

可选

多账号时必传

customReqId

string | null

用户标识ID

可选

传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb

示例

{
  "nsrsbh": "91**************2G",
  "skssq": "202405",
  "gxlx": "1",
  "list": [
    {
      "jkshm": "03*********************46-L02",
      "zmbh": "",
      "tfrq": "2024-06-01",
      "se": 100,
      "yxse": 26.89
    }
  ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object | null

业务数据

可选

list

array [object {19}] | null

海关缴款书列表

可选

enum<string>

任务状态

必需

2-申请处理失败；3-申请处理完成；

枚举值:

code

string

错误码

必需

当任务状态zt=2时返回对应错误码

message

string

错误信息

必需

当任务状态zt=2时返回对应错误信息

示例

{
  "reqId": "a1ced94a044748eea2b3c601a3944ed5",
  "code": "2000",
  "success": true,
  "message": null,
  "data": {
    "code": null,
    "customReqId": "1000199942e88d10e4f44d148656f48b7ae3b3eb",
    "list": [
      {
        "bdkyy": "",
        "bdkyyms": "",
        "cljg": "1",
        "code": null,
        "fplx": "17",
        "gfsbh": "91***************7E",
        "glzt": "0",
        "gxlx": "1",
        "gxsj": "2024-02-27 22:58:18",
        "gxzt": "1",
        "jkshm": "22***************39-L02",
        "kprq": "2024-01-26 00:00:00",
        "message": null,
        "se": 1945.01,
        "skssq": "202403",
        "yskssq": null,
        "yxse": 1945.01,
        "zt": "3"
      }
    ],
    "message": null,
    "zt": "3"
  }
}

🟢200任务转异步

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码