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

请求参数

Body 参数application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

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

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：CKBGD

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：XINVOICE.PUT

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

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

startDate

string

录入开始日期

必需

例：yyyy-mm-dd

>= 0 字符<= 10 字符

endDate

string

录入结束日期

必需

例：yyyy-mm-dd

>= 0 字符<= 10 字符

page

integer

当前页数

必需

例：开始为1

pageSize

integer

页数

必需

例：默认20

dNo

string

单据号

可选

例：单据号不为空，那么按单据号查询其它条件可为空则按条件查询

>= 0 字符<= 15 字符

fpLx

string

发票类型

可选

例：0:专用发票 2:普通发票 10:电票

>= 0 字符<= 2 字符

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/xinvoice/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "YXBwX3NlY2lkemhvbmdzaHVpY2hlbmc=",
        "appSec": "mqdIMdaw1IYTc9m0UFsZgax3Fb0="
    },
    "globalInfo": {
        "appId": "XXFP",
        "version": "V1.0",
        "interfaceCode": "XINVOICE.GET",
        "enterpriseCode": "ZSC",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIyMDE4LTA4LTAxIiwicGFnZSI6MSwicGFnZVNpemUiOjEwLCJkTm8iOiIxMjM0NTY3ODkwMTIxMiIsImVuZERhdGUiOiIyMDE4LTA4LTA2IiwiZnBMeCI6IjAifQ=="
}
//data加密的字符串
{
    "startDate": "2018-07-01",
    "endDate": "2018-08-01",
    "page": 1,
    "pageSize": 20,
    "dNo": "2323232323232323",
    "fplx": "0",
    "optStartDate": "2018-12-10",
    "optEndDate": "2018-12-10"

}'

返回响应

🟢200成功

application/json

Body

dno

string

单据号

必需

例：KP20171122152850871

>= 0 字符<= 10 字符

sqrq

string

申请日期

必需

例：yyyy-mm-dd

>= 0 字符<= 10 字符

gfmc

string

购方名称

必需

例：

>= 0 字符<= 100 字符

gfswsbh

string

购方税号

必需

例：

>= 0 字符<= 18 字符

fpLx

string

发票类型

必需

例：0专2普10电票

>= 0 字符<= 10 字符

taxFlag

string

含税标志

必需

例：0否1是

>= 0 字符<= 1 字符

fpDm

string

发票代码

必需

例：

>= 0 字符<= 20 字符

fpNo

string

发票号码

必需

例：

>= 0 字符<= 20 字符

kprq

string

开票日期

必需

例：yyyy-mm-dd

>= 0 字符<= 10 字符

status

string

发票状态

必需

例：发票状态 0：正常 1：失控 2：作废 3：红冲 4：异常 5：认证异常

>= 0 字符<= 1 字符

rn

string

行号

必需

例：

>= 0 字符<= 10 字符

hNo

string

商品行号

必需

例：

>= 0 字符<= 30 字符

cmname

string

商品名称

必需

例：

>= 0 字符<= 100 字符

je

string

金额

必需

例：

>= 0 字符<= 15 字符

se

string

税额

必需

例：

>= 0 字符<= 15 字符

sl

string

税率

必需

例：

>= 0 字符<= 15 字符

totalRows

string

总行数

可选

例：100

>= 0 字符<= 10 字符

Result（销项发票信息）

string

Result（销项发票信息）

可选

例：

>= 0 字符<= 10 字符

gfdz

string

购方地址

可选

例：

>= 0 字符<= 200 字符

gfphone

string

购方电话

可选

例：

>= 0 字符<= 20 字符

gfacc

string

购方银行账号

可选

例：

>= 0 字符<= 80 字符

gfkhh

string

购方开户行

可选

例：

>= 0 字符<= 100 字符

remark

string

备注

可选

例：

>= 0 字符<= 220 字符

skr

string

收款人

可选

例：

>= 0 字符<= 16 字符

fhr

string

复核人

可选

例：

>= 0 字符<= 16 字符

kpr

string

开票人

可选

例：

>= 0 字符<= 16 字符

zfrq

string

作废日期

可选

例：yyyy-mm-dd

>= 0 字符<= 10 字符

pdfUrl

string

PDF下载地址

可选

例：

>= 0 字符<= 300 字符

spUrl

string

收票地址

可选

例：用该地址生成二维码，供用户扫码获取发票

>= 0 字符<= 300 字符

detailList（商品明细）

string

detailList（商品明细）

可选

例：

>= 0 字符<= 10 字符

cmcode

string

商品编码

可选

例：

>= 0 字符<= 20 字符

cmggxh

string

规格型号

可选

例：

>= 0 字符<= 200 字符

unit

string

计量单位

可选

例：

>= 0 字符<= 10 字符

qnt

string

数量

可选

例：

>= 0 字符<= 15 字符

pri

string

单价

可选

例：

>= 0 字符<= 38 字符

示例

加密返回成功示例解码后data示例

{
    "data": "eyJ0b3RhbFJvd3MiOjEsInhpbnZvaWNlcyI6W3siZE5vIjoiMTIzNDU2Nzg5MDEyMTIiLCJkZXRhaWxMaXN0IjpbeyJjbWNvZGUiOiIxMTExMTExMSIsImNtZ2d4aCI6Iua1i+ivleinhOagvOWei+WPtzEiLCJjbW5hbWUiOiLmtYvor5XllYblk4ExIiwiaE5vIjoiMSIsImplIjoiMTAiLCJwcmkiOiIxIiwicW50IjoiMTAiLCJzZSI6Ii42Iiwic2wiOiIuMDYiLCJ1bml0Ijoi5LiqIn0seyJjbWNvZGUiOiIxMTExMTExMSIsImNtZ2d4aCI6Iua1i+ivleinhOagvOWei+WPtzEiLCJjbW5hbWUiOiLmtYvor5XllYblk4ExIiwiaE5vIjoiMSIsImplIjoiMTAiLCJwcmkiOiIxIiwicW50IjoiMTAiLCJzZSI6Ii42Iiwic2wiOiIuMDYiLCJ1bml0Ijoi5LiqIn1dLCJmaHIiOiLmtYvor5XkurrlkZgiLCJmcERtIjoiICIsImZwTHgiOiLkuJPnlKjlj5HnpagiLCJmcE5vIjoiICIsImdmYWNjIjoiMTExMTExMTExMTExMTExMSIsImdmYWRkIjoi5YyX5Lqs5rW35reA57Sr56u56ZmiIiwiZ2ZraGgiOiLljJfkuqzmi5vllYbpk7booYwiLCJnZm1jIjoi5YyX5Lqs5a6H5bed56eR5oqA5pyJ6ZmQ5YWs5Y+4IiwiZ2ZwaG9uZSI6IjEyMzQ1Njc4ODkiLCJnZnN3c2JoIjoiMTExMTExMTExMTExMSIsImtwcnEiOiIyMDE4LTA4LTAzIiwicmVtYXJrIjoi5rWL6K+V5byA56WoIiwicm4iOjEsInNrciI6Iua1i+ivleS6uuWRmCIsInN0YXR1cyI6IjAiLCJ0YXhGbGFnIjoiMSJ9XX0=",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}