GETPublicinvoice-check

Invoice Verification

Enter invoice details to verify its authenticity.

Documentation

Enter invoice details to verify its authenticity.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Shell ExamplePython ExampleGo ExampleJava ExamplePHP Example

Shell Example

curl --request GET \
  --url 'https://openapi.toolkk.com/invoice/check' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/invoice/check"
payload = {}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.get(url, headers=headers, params=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go Example

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/invoice/check"
    payload := []byte("{}")

    req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

Request Example

{}

Response Example

{
  "code": 200,
  "data": {
    "info": {
      "type": "object",
      "properties": {
        "notes": {
          "type": "string",
          "example": "",
          "description": "发票备注"
        },
        "status": {
          "type": "string",
          "example": "1",
          "description": "发票状态 1、未作废　2、作废 3、红冲"
        },
        "verCode": {
          "type": "string",
          "example": "2433200*****274660945",
          "description": "校验码"
        },
        "itemList": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "example": "*信息技术服务*技术服务费",
                "description": "商品名称"
              },
              "spec": {
                "type": "string",
                "example": "",
                "description": "规格"
              },
              "unit": {
                "type": "string",
                "example": "",
                "description": "单位"
              },
              "amount": {
                "type": "string",
                "example": "1",
                "description": "数量"
              },
              "taxAmt": {
                "type": "string",
                "example": "5.66",
                "description": "税额"
              },
              "taxRate": {
                "type": "string",
                "example": "0.06",
                "description": "税率"
              },
              "priceAmt": {
                "type": "string",
                "example": "94.34",
                "description": "金额"
              },
              "priceUnit": {
                "type": "string",
                "example": "94.3396226415094",
                "description": "单价"
              }
            }
          },
          "example": [
            {
              "name": "*信息技术服务*技术服务费",
              "spec": "",
              "unit": "",
              "amount": "1",
              "taxAmt": "5.66",
              "taxRate": "0.06",
              "priceAmt": "94.34",
              "priceUnit": "94.3396226415094"
            }
          ]
        },
        "ret_code": {
          "type": "number",
          "example": 0,
          "description": "无效字段"
        },
        "totalAmt": {
          "type": "string",
          "example": "100.00",
          "description": "价税合计"
        },
        "buyerBank": {
          "type": "string",
          "example": "交通银行****支行 411621********230210",
          "description": "购方开户行账户"
        },
        "buyerName": {
          "type": "string",
          "example": "河南********有限公司",
          "description": "购方名称"
        },
        "invoiceNo": {
          "type": "string",
          "example": "243320*********45",
          "description": "发票号码"
        },
        "salerBank": {
          "type": "string",
          "example": "",
          "description": "销方开户行账户"
        },
        "salerName": {
          "type": "string",
          "example": "杭州*****有限公司",
          "description": "销方名称"
        },
        "buyerTaxNo": {
          "type": "string",
          "example": "9141*********8T8M",
          "description": "购方税号"
        },
        "invoiceAmt": {
          "type": "string",
          "example": "94.34",
          "description": "合计金额"
        },
        "salerTaxNo": {
          "type": "string",
          "example": "913*********72B",
          "description": "销方税号"
        },
        "invoiceCode": {
          "type": "string",
          "example": "",
          "description": "发票代码"
        },
        "invoiceDate": {
          "type": "string",
          "example": "2024-08-15",
          "description": "开票日期"
        },
        "machineCode": {
          "type": "string",
          "example": "",
          "description": "机器编码"
        },
        "totalTaxAmt": {
          "type": "string",
          "example": "5.66",
          "description": "合计税额"
        },
        "buyerContact": {
          "type": "string",
          "example": "河南自贸试验区********号 0371-66****67",
          "description": "购方地址电话"
        },
        "salerContact": {
          "type": "string",
          "example": "浙江省杭州市********室 0571-8******1",
          "description": "销方地址电话"
        }
      }
    },
    "result": {
      "type": "string",
      "example": "一致",
      "description": "校验结果，一致、不一致"
    },
    "orderNo": {
      "type": "string",
      "example": "935774813741997730"
    }
  },
  "message": "success"
}

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	number	200
data	object	{...}
data.info	object	{...}
data.info.type	string	object
data.result	object	{...}
data.result.type	string	string
data.result.example	string	一致