同步进项发票 - 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/syncInvoiceData' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200OK

application/json

Body

Banas 返回结果

result

object (SyncJxfpResponse)

可选

同步发票信息返回参数

list

array[object (SyncInvoice) {28}] | null

发票详情

可选

zt

string | null

可选

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

code

string | null

代码

可选

message

string | null

信息

可选

status

integer <int32>

可选

状态码 200 成功

errorMessage

string | null

异常信息

可选

示例

{
  "result": {
    "list": [
      {
        "qdfphm": "string",
        "fpdm": "string",
        "fphm": "string",
        "jym": "string",
        "kprq": "string",
        "je": 0,
        "se": 0,
        "yxse": 0,
        "xfmc": "string",
        "xfsbh": "string",
        "fply": "string",
        "fplx": "string",
        "fpzt": "string",
        "skssq": "string",
        "yskssq": "string",
        "hzsdbz": true,
        "znxzmbh": "string",
        "ywlx": "string",
        "gxzt": "string",
        "gxlx": "string",
        "ycfpbsDm": "string",
        "gxsj": "string",
        "fxdjDm": "string",
        "gfmc": "string",
        "gfsbh": "string",
        "bdkyy": "string",
        "bdkyyms": "string",
        "ncpfpbz": true
      }
    ],
    "zt": "string",
    "code": "string",
    "message": "string"
  },
  "status": 0,
  "errorMessage": "string"
}