2.2.06税控发票库存查询

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/sim/openApi

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

接口编码

必需

枚举值:

INVOICE.STOCK.QUERY

data

object

必需

需要把data里面的object加密成base64字符串

taxNo

string

必需

销售方纳税人识别号【长度：20】

deviceNo

string

可选

设备编号，为空时系统根据税号随机选择【长度：20】

terminalNo

string

可选

终端号，为空系统随机选择【最大长度：4】

invoiceType

string

可选

发票种类， 028：增值税电子专用发票 004：增值税纸质专用发票 026：增值税电子普通发票 007：增值税纸质普通发票【长度：4】

示例

{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": "INVOICE.STOCK.QUERY",
    "data": {
        "taxNo": "string",
        "deviceNo": "string",
        "terminalNo": "string",
        "invoiceType": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": "INVOICE.STOCK.QUERY",
    "data": {
        "taxNo": "string",
        "deviceNo": "string",
        "terminalNo": "string",
        "invoiceType": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

data

object

必需

需要把data里面的object加密成base64字符串

normalEInvoiceStock

number

必需

普通电子发票剩余票量

normalPaperInvoiceStock

number

必需

普通纸质发票剩余票量

specialPaperInvoiceStock

number

必需

专用纸质发票剩余票量

specialEInvoiceStock

number

必需

专用电子发票剩余票量

equipmentType

string

必需

设备类型 0-税务UKEY 1-税控盘 2-金税盘

示例

{
    "message": "string",
    "errorCode": "string",
    "success": true,
    "data": {
        "normalEInvoiceStock": 0,
        "normalPaperInvoiceStock": 0,
        "specialPaperInvoiceStock": 0,
        "specialEInvoiceStock": 0,
        "equipmentType": "string"
    }
}

修改于 2024-02-21 08:58:54

2.2.05税控红字信息表下载