15、发票抵扣勾选

测试环境(除税控、数电和扫码开票外的接口）

https://api-dev.piaozone.com/test

POST

请求参数

Query 参数

access_token

string

必需

发票云租户授权token

示例值:

发票云租户授权token

reqid

string

必需

链路id，用于跟踪排查问题，建议不少于13位

示例值:

链路id，用于跟踪排查问题，建议不少于13位

taxNo

string

授权对应的企业税号

必需

示例值:

授权对应的企业税号

name

string

可选

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

示例值:

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

Body 参数application/json

account

string

可选

电子税局账号，选填，不传则使用配置的默认电子税局账号

request_path

string

必需

/fpdk/dkgx/gxInvoices

authenticateFlag

number

必需

勾选标志（勾选传1，撤销勾选传0）

taxNo

string

企业税号

必需

invoices

array [object {10}]

发票数组

必需

salerName

string

发票销方名称

可选

salerTaxNo

string

发票销方税号

可选

invoiceType

number

发票类型

可选

invoiceCode

string

发票代码

可选

etaxInvoiceNo

string

纸质数电票号码

可选

invoiceNo

string

发票号码

可选

invoiceDate

string

开票日期

可选

invoiceAmount

string

不含税金额

可选

effectiveTaxAmount

string

有效税额

可选

totalTaxAmount

string

总税额

可选

示例

{
    "account": "string",
    "request_path": "string",
    "authenticateFlag": 0,
    "taxNo": "string",
    "invoices": [
        {
            "salerName": "string",
            "salerTaxNo": "string",
            "invoiceType": 0,
            "invoiceCode": "string",
            "etaxInvoiceNo": "string",
            "invoiceNo": "string",
            "invoiceDate": "string",
            "invoiceAmount": "string",
            "effectiveTaxAmount": "string",
            "totalTaxAmount": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/?access_token=发票云租户授权token&reqid=链路id，用于跟踪排查问题，建议不少于13位&taxNo=授权对应的企业税号&name=数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "string",
    "request_path": "string",
    "authenticateFlag": 0,
    "taxNo": "string",
    "invoices": [
        {
            "salerName": "string",
            "salerTaxNo": "string",
            "invoiceType": 0,
            "invoiceCode": "string",
            "etaxInvoiceNo": "string",
            "invoiceNo": "string",
            "invoiceDate": "string",
            "invoiceAmount": "string",
            "effectiveTaxAmount": "string",
            "totalTaxAmount": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

traceId用于排查异常

errcode

string

必需

//90000: 当前没有可以确认的发票, 90001: 为部分勾选成功，0000: 为全部勾选成功, 91300: 电子税局登录失效需要重新打开登录页

description

string

响应描述

必需

data

object

必需

taxPeriod

string

抵扣税期

必需

success

array [object {6}]

成功发票数组

必需

fail

array [object {5}]

失败发票数组

必需

示例

{
    "traceId": "string",
    "errcode": "string",
    "description": "string",
    "data": {
        "taxPeriod": "string",
        "success": [
            {
                "invoiceCode": "string",
                "invoiceNo": "string",
                "invoiceDate": "string",
                "selectDate": "string",
                "description": "string",
                "selectResult": "string"
            }
        ],
        "fail": [
            {
                "invoiceCode": "string",
                "invoiceNo": "string",
                "invoiceDate": {},
                "description": "string",
                "selectResult": "string"
            }
        ]
    }
}

修改于 2025-04-18 06:16:14

14、当期已勾选或往期已认证缴款书（税盘模式不支持）

billTypeCode表