开放平台API
  • 海关数据
  • 进项数据
    • 进项发票获取接口POST
    • 进项发票查验接口POST
    • 进项异常发票获取接口POST
    • 进项票据OCR识别接口POST
  • 销项数据
  • 退税数据
  • 企业数据
  • 开票服务
logoPowered by Apifox
  1. 进项数据

进项发票获取接口

POST/post/rest/invoice/dii

此接口支持获取企业自身的进项发票数据（含：发票的号码，代码，开票日期，发票状态，购销方信息，备注，金额，税额，商品，规格型号，单位，单价，数据等信息），帮助企业及时拿到发票数据，提升工作效率，同时规避税务的风险。

请求参数

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 
最新操作开始日期
可选

格式：yyyy-MM-dd

optEndDate
string 
最新操作结束日期
可选

格式：yyyy-MM-dd

pageSize
integer 
页数
必需

默认10条

page
integer 
当前第几页
必需

默认从1开始

startDate
string 
开票开始日期
可选

格式：yyyy-MM-dd

示例
{
  "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)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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
}
最后修改时间： 8 个月前