进项发票获取接口 - 开放平台API

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

根据密钥ID和KEY生成的签名串

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：JXFP

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：INVOICE.GET

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

由获取条件参数通过用Base64加密生成的字符串

fpDm

string

发票代码

可选

fpNo

string

发票号码

可选

endDate

string

开票结束日期

可选

格式：yyyy-MM-dd

optStartDate

string

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://117.78.0.163/51GP/post/rest/invoice/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9382946836623A9D2",
        "appSec": "A77C6C88DBF4866250CD4BA60D40EE85"
    },
    "globalInfo": {
        "appId": "JXFP",
        "version": "V1.0",
        "interfaceCode": "INVOICE.OA.DGET",
        "enterpriseCode": "ZWGX",
        "dataExchangeId": "decrypt"
    },
    "data": {
        "startDate": "",
        "endDate": "",
        "page": 1,
        "pageSize": 20,
        "fpDm": "011001700112",
        "fpNo": "62477900",
        "invoiceType": "ZZS",
        "optStartDate": "",
        "optEndDate": ""
    }
}'

返回响应

🟢200成功

application/json

Body

data

object

返回参数

必需

由返回的参数通过用Base64加密生成的字符串

result

array [object {30}]

发票列表数据

必需

totalRows

integer

数据的总条数

必需

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功

示例


{
    "data": "eyJyZXN1bHQiOlt7ImJzd2pVcmwiOiIgIiwiYnV5ZXJUYXhObyI6IjkxMTEwMDAwMT....",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}

//data加密前的数据
{
    "result": [
        {
            "bswjUrl": " ",
            "buyerTaxNo": "91110000100006389A",
            "checkCode": " ",
            "currentTaxPeriod": " ",
            "detailList": [
                {
                    "cmcode": " ",
                    "cmggxh": " ",
                    "cmname": "*鉴证咨询服务*检验费",
                    "hNo": "1",
                    "je": "3204",
                    "pri": "3204",
                    "qnt": "1",
                    "se": "192.24",
                    "sl": "6",
                    "unit": "项"
                }
            ],
            "fpDm": null,
            "fpNo": "22312000000001242403",
            "fpcc": " ",
            "fpzlDm": "31",
            "invoiceAmount": "3204",
            "invoiceDate": "2022-11-01",
            "invoiceStatus": "0",
            "legalizeBlongDate": " ",
            "legalizeDate": null,
            "legalizeState": " ",
            "legalizeType": " ",
            "note": "IQB 241929",
            "qdbz": " ",
            "rn": 1,
            "rzlx": "0",
            "salerAccNo": "1001189709006809947",
            "salerKhh": " ",
            "salerLxdh": "671",
            "salerName": "必维毕法克检验（上海）有限公司",
            "salerTaxNo": "9131000076164787XD",
            "salerZcdz": "上海市杨浦区伟德路6号1302-11室58352011×",
            "sfdbts": " ",
            "taxAmount": "192.24",
            "taxRate": "6",
            "totalAmount": null
        }
    ],
    "totalRows": 1
}