开放平台API
  1. 进项数据
开放平台API
  • 海关数据
    • 出口报关单获取接口
      POST
    • 进口报关单获取接口
      POST
    • 进口税单获取接口
      POST
    • 保证金获取接口
      POST
    • 海关编码获取接口
      POST
    • 退税商品编码获取接口
      POST
    • 下载任务状态查询
      POST
  • 进项数据
    • 进项发票获取接口
      POST
    • 进项发票查验接口
      POST
    • 进项异常发票获取接口
      POST
    • 进项票据OCR识别接口
      POST
  • 销项数据
    • 销项发票申请接口
      POST
    • 销项发票获取接口
      POST
    • 销项发票红冲接口
      POST
    • 销项发票作废接口
      POST
    • 记账凭证回推接口-XINVOICE.DBACK
      POST
  • 退税数据
    • 生产企业
    • 外贸企业
      • 退税申报批次-汇总数据申请下载接口
      • 退税申报批次-汇总数据查询(下载完成后调用)
      • 自检状态查询
    • 退税申报批次申请下载接口
      POST
    • 退税申报批次数据获取接口
      POST
    • 已申报批次基本信息获取接口
      POST
  • 企业数据
    • 企业信息获取接口
      POST
    • 是否一般纳税人查询接口
      POST
    • 税局违法企业获取接口
      POST
    • 企业财税数据获取接口
      POST
    • 企业开通申请接口
      POST
    • 企业开通申请结果获取接口
      POST
    • 企业备案信息申请下载接口
      POST
    • 企业备案信息结果获取接口
      POST
    • 企业开通申请接口WEB版
      POST
    • 渠道关联企业-续期接口WEB版
      POST
  • 开票服务
    • 登录电票平台接口
    • 获取是否需要人脸识别接口
    • 获取人脸识别二维码接口
  • 其他数据服务
    • 汇率查询
  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.YC
enterpriseCode
string 
企业编码
必需
dataExchangeId
string 
接口数据加密
必需
例:默认值dataExchangeId
data
object 
获取条件参数
必需
由获取条件参数通过用Base64加密生成的字符串
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": "2AE5415E6FBD2BE998C14B09AB8DAF71",
        "appSec": "Nod43aDQZuKplCFJ/6IWHGFmgWQ="
    },
    "globalInfo": {
        "appId": "JXFP",
        "version": "V1.0",
        "interfaceCode": "INVOICE.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MSwicGFnZVNpemUiOjIwLCJmcERtIjoiIiwiZnBObyI6IiIsIm9wdFN0YXJ0RGF0ZSI6IjIwMjAtMDMtMjUiLCJvcHRFbmREYXRlIjoiMjAyMi0xMi0wOSJ9"
}

//data加密前的参数
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 20,
    "fpDm": "",
    "fpNo": "",
    "optStartDate": "2020-03-25",
    "optEndDate": "2022-12-09"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://117.78.0.163/51GP/post/rest/invoice/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE998C14B09AB8DAF71",
        "appSec": "Nod43aDQZuKplCFJ/6IWHGFmgWQ="
    },
    "globalInfo": {
        "appId": "JXFP",
        "version": "V1.0",
        "interfaceCode": "INVOICE.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MSwicGFnZVNpemUiOjIwLCJmcERtIjoiIiwiZnBObyI6IiIsIm9wdFN0YXJ0RGF0ZSI6IjIwMjAtMDMtMjUiLCJvcHRFbmREYXRlIjoiMjAyMi0xMi0wOSJ9"
}

//data加密前的参数
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 20,
    "fpDm": "",
    "fpNo": "",
    "optStartDate": "2020-03-25",
    "optEndDate": "2022-12-09"
}'

返回响应

🟢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": "913101153987159026",
            "checkCode": " ",
            "currentTaxPeriod": " ",
            "detailList": [
                {
                    "cmcode": "1090519060000000000",
                    "cmggxh": "H340",
                    "cmname": "*电子元件*罗技(Logitech) H340 USB耳机耳麦头戴式台式机电脑耳机有线 带麦克风话筒话务客服办",
                    "hNo": "1",
                    "je": "263.72",
                    "pri": "131.86",
                    "qnt": "2",
                    "se": "34.28",
                    "sl": "13",
                    "unit": "副"
                },
                {
                    "cmcode": "1090519060000000000",
                    "cmggxh": " ",
                    "cmname": "*电子元件*罗技(Logitech) H340 USB耳机耳麦头戴式台式机电脑耳机有线 带麦克风话筒话务客服办",
                    "hNo": "2",
                    "je": "-53.1",
                    "pri": "0",
                    "qnt": "0",
                    "se": "-6.9",
                    "sl": "13",
                    "unit": " "
                }
            ],
            "fpDm": "3100231130",
            "fpNo": "00895942",
            "fpcc": " ",
            "fpzlDm": "1130",
            "invoiceAmount": "210.62",
            "invoiceDate": "2023-07-14",
            "invoiceStatus": "2",
            "legalizeBlongDate": " ",
            "legalizeDate": null,
            "legalizeState": " ",
            "legalizeType": " ",
            "note": "dd73955244161(00001,\\n274802354233)",
            "qdbz": "0",
            "rn": 1,
            "rzlx": " ",
            "salerAccNo": "310069079018010104673",
            "salerKhh": "交通银行上海嘉定支行",
            "salerLxdh": "021-39123250",
            "salerName": "上海圆迈贸易有限公司",
            "salerTaxNo": "91310114666025597Y",
            "salerZcdz": "上海市嘉定工业区叶城路1118号19层1901室",
            "sfdbts": " ",
            "taxAmount": "27.38",
            "taxRate": "0",
            "totalAmount": null
        },
        {
            "bswjUrl": null,
            "buyerTaxNo": " ",
            "checkCode": null,
            "currentTaxPeriod": null,
            "detailList": [
                {
                    "cmcode": " ",
                    "cmggxh": "沙发十大萨达发",
                    "cmname": "技术服务费",
                    "hNo": "1",
                    "je": "50000",
                    "pri": "50000",
                    "qnt": "1",
                    "se": "3000",
                    "sl": ".06",
                    "unit": "件"
                }
            ],
            "fpDm": "1100171130",
            "fpNo": "01254642",
            "fpcc": null,
            "fpzlDm": "1130",
            "invoiceAmount": "50000",
            "invoiceDate": "2017-11-01",
            "invoiceStatus": "2",
            "legalizeBlongDate": null,
            "legalizeDate": null,
            "legalizeState": "0",
            "legalizeType": null,
            "note": "说法阿萨德答复是大",
            "qdbz": null,
            "rn": 2,
            "rzlx": null,
            "salerAccNo": "630070700",
            "salerKhh": "中国民生银行紫竹支行",
            "salerLxdh": "010-53779958",
            "salerName": "中税诚(北京)科技有限公司",
            "salerTaxNo": "91110111MA006E139W",
            "salerZcdz": "海淀区紫竹院路31号华澳中心嘉慧苑903 ",
            "sfdbts": null,
            "taxAmount": "3000",
            "taxRate": null,
            "totalAmount": null
        }
    ],
    "totalRows": 2
}
修改于 2023-12-14 03:24:28
上一页
进项发票查验接口
下一页
进项票据OCR识别接口
Built with