2.2.04税控红字信息表申请

快速开始环境

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

POST

/kapi/app/sim/openApi

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

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

interfaceCode

enum<string>

接口编码

必需

枚举值:

REDINFOBILL.APPLY

data

array [object {19}]

必需

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

serialNo

string

单据编号

必需

orgCode

string

可选

组织编码,如果没有填写，会根据销方税号找到企业的主体组织，用来设置组织信息

applyTaxpayerId

string

必需

申请方纳税人识别号【长度：20】

applyExplain

string

必需

0：购方申请-发票已抵扣； 1：购方申请-发票未抵扣；2：销方申请；默认为销方申请【长度：10】

originalInvoiceCode

string

可选

原发票代码，当申请理由为“销方申请”和“购方申请-发票未抵扣”时必填； 2，为“购方申请-发票已抵扣”时可以为空【长度：12】

originalInvoiceNumber

string

可选

原发票号码,当申请理由为“销方申请”和“购方申请-发票未抵扣”时必填； 2，为“购方申请-发票已抵扣”时可以为空

originalInvoiceDate

string

必需

原开票日期，当申请理由为“销方申请”和“购方申请-发票未抵扣”时必填； 2，为“购方申请-发票已抵扣”时可以为空

includeTaxFlag

string

必需

含税标识 0-不含税 1-含税

buyerName

string

可选

购方名称，applyExplain为2时必填，【最大长度：100】

buyerTaxpayerId

string

可选

购方税号，applyExplain为2时必填，购买方性质为非企业时可为空，为企业时若未传入则用名称匹配系统维护的税号【长度：20】

buyerBankAndAccount

string

可选

购方银行和账号，applyExplain为2时必填，【最大长度：100】

buyerAddressAndTel

string

可选

购方地址和电话，applyExplain为2时必填，【最大长度：100】

sellerName

string

必需

销方名称，applyExplain为0/1时，必填；applyExplain为2时可不填【最大长度：100】

sellerBankAndAccount

string

必需

销方银行和账号，applyExplain为0/1时，必填；applyExplain为2时可不填【最大长度：100】

sellerAddressAndTel

string

必需

销方地址和电话，applyExplain为0/1时，必填；applyExplain为2时可不填【最大长度：100】

sellerTaxpayerId

string

必需

销售方纳税人识别号【长度：20】，applyExplain为0/1时，必填；applyExplain为2时可不填

invoiceType

string

必需

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

redInfoBillDetail

array [object {14}]

数组长度不大于8

必需

deviceNo

string

必需

设备编号【长度：20】

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": " REDINFOBILL.APPLY",
  "data": [
    {
      "serialNo": "string",
      "orgCode": "string",
      "applyTaxpayerId": "string",
      "applyExplain": "string",
      "originalInvoiceCode": "string",
      "originalInvoiceNumber": "string",
      "originalInvoiceDate": "string",
      "includeTaxFlag": "string",
      "buyerName": "string",
      "buyerTaxpayerId": "string",
      "buyerBankAndAccount": "string",
      "buyerAddressAndTel": "string",
      "sellerName": "string",
      "sellerBankAndAccount": "string",
      "sellerAddressAndTel": "string",
      "sellerTaxpayerId": "string",
      "invoiceType": "string",
      "redInfoBillDetail": [
        {
          "goodsCode": "string",
          "goodsName": "string",
          "specification": "string",
          "units": "string",
          "quantity": 0,
          "price": 0,
          "amount": 0,
          "taxRate": "string",
          "taxAmount": 0,
          "revenueCode": "string",
          "privilegeFlag": "01",
          "privilegeContent": "string",
          "zeroTaxRateFlag": "string",
          "lineProperty": "string"
        }
      ],
      "deviceNo": "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 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " REDINFOBILL.APPLY",
    "data": [
        {
            "serialNo": "string",
            "orgCode": "string",
            "applyTaxpayerId": "string",
            "applyExplain": "string",
            "originalInvoiceCode": "string",
            "originalInvoiceNumber": "string",
            "originalInvoiceDate": "string",
            "includeTaxFlag": "string",
            "buyerName": "string",
            "buyerTaxpayerId": "string",
            "buyerBankAndAccount": "string",
            "buyerAddressAndTel": "string",
            "sellerName": "string",
            "sellerBankAndAccount": "string",
            "sellerAddressAndTel": "string",
            "sellerTaxpayerId": "string",
            "invoiceType": "string",
            "redInfoBillDetail": [
                {
                    "goodsCode": "string",
                    "goodsName": "string",
                    "specification": "string",
                    "units": "string",
                    "quantity": 0,
                    "price": 0,
                    "amount": 0,
                    "taxRate": "string",
                    "taxAmount": 0,
                    "revenueCode": "string",
                    "privilegeFlag": "01",
                    "privilegeContent": "string",
                    "zeroTaxRateFlag": "string",
                    "lineProperty": "string"
                }
            ],
            "deviceNo": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

data

object

必需

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

hzxxbm

string

红字信息表编码

可选

sqdh

string

申请单号

必需

ztm

string

税局审核状态码

必需

示例

{
  "message": "string",
  "errorCode": "string",
  "success": true,
  "data": {
    "hzxxbm": "string",
    "sqdh": "string",
    "ztm": "string"
  }
}

🟢200失败

2.2.03税控发票作废

2.2.05税控红字信息表下载