同步海关缴款书 - Banas 开放平台

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

同步进项发票数据请求参数

uid

string

唯一编码

必需

>= 16 字符<= 36 字符

nsrsbh

string

税号

必需

>= 1 字符

dlsfsjh

string

登录身份手机号

必需

>= 1 字符

pageSize

integer <int32>

分页大小

必需

pageNumber

integer <int32>

当前页

必需

cjlx

string

必需

采集类型单次请求仅允许单个采集类型。例如：1（抵扣未勾选发票采集）。 1-抵扣未勾选发票 2-当期抵扣已勾选发票 3-当期不抵扣已勾选发票 4-当期退税已勾选发票 5-未到勾选日期的发票如同时传入gxzt，则指定的采集类型cjlx必须与勾选状态gxzt匹配，即未勾选发票采集gxzt必须等于0，已勾选发票采集gxzt必须等于1。

>= 1 字符

gxzt

enum<integer> <int32>

必需

勾选状态
未勾选 = 0
已勾选 = 1

枚举值:

01

kprqq

string | null

可选

开票日期起 yyyy-MM-dd

>= 0 字符<= 10 字符

kprqz

string | null

可选

开票日期止 yyyy-MM-dd

>= 0 字符<= 10 字符

fpzt

enum<integer> <int32>

可选

发票状态

0 正常
1 作废
2 已红冲-部分
3 已红冲-全额
正常 = 0
作废 = 1
已红冲部分 = 2
已红冲全额 = 3

枚举值:

0123

fplx

string | null

可选

发票类型不填默认采集全部类型的发票，如填写，可填多个发票类型，以“，”隔开
01增值税专用发票；03 机动车销售统一发票；04增值税普通发票；08 增值税电子专用发票；10增值税电子普通发票；14通行费发票；51全电发票（铁路电子客票）；61全电发票（航空运输电子客票行程单）；81全电发票(增值税专用发票)；82全电发票（增值税普通发票）；85全电纸质发票(增值税专用发票)；86 全电纸质发票（增值税普通发票）

示例

{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "pageSize": 0,
    "pageNumber": 0,
    "cjlx": "string",
    "gxzt": 0,
    "kprqq": "string",
    "kprqz": "string",
    "fpzt": 0,
    "fplx": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://banas.ccitcn.com/api/income/syncHgjksData' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid": "stringstringstri",
    "nsrsbh": "string",
    "dlsfsjh": "string",
    "pageSize": 0,
    "pageNumber": 0,
    "cjlx": "string",
    "gxzt": 0,
    "kprqq": "string",
    "kprqz": "string",
    "fpzt": 0,
    "fplx": "string"
}'

返回响应

🟢200OK

application/json

Body

Banas 返回结果

result

object (SyncHgjksResponse)

可选

list

array[object (Hgjks) {25}] | null

发票详情

可选

zt

string | null

可选

任务状态 1进行中，2失败，3成功

code

string | null

代码

可选

message

string | null

信息

可选

status

integer <int32>

可选

状态码 200 成功

errorMessage

string | null

异常信息

可选

示例

{
    "result": {
        "list": [
            {
                "fplx": "string",
                "jkshm": "string",
                "kprq": "string",
                "gfsbh": "string",
                "gfmc": "string",
                "xfsbh": "string",
                "xfmc": "string",
                "je": 0,
                "se": 0,
                "fpzt": "string",
                "gxzt": "string",
                "gxsj": "string",
                "gxlx": "string",
                "yxse": 0,
                "skssq": "string",
                "yskssq": "string",
                "sfdbts": "string",
                "yqkgxbz": "string",
                "glzt": "string",
                "yclx": "string",
                "fply": "string",
                "bdkyy": "string",
                "bdkyyms": "string",
                "hzsdbz": "string",
                "ncpfpbz": "string"
            }
        ],
        "zt": "string",
        "code": "string",
        "message": "string"
    },
    "status": 0,
    "errorMessage": "string"
}