A specialized tool for verifying the authenticity and details of Chinese invoices using the official Huisuiyun API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install invoice-verify-hsy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install invoice-verify-hsy using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Huisuiyun Invoice Verification?
The Huisuiyun Invoice Verification skill provides a robust interface for AI agents to validate official Chinese invoices directly through the Huisuiyun API. By integrating this skill into your workflow, you can programmatically verify invoice codes, numbers, issuance dates, and amounts to ensure financial compliance and prevent fraud. This tool is a key part of the Openclaw Skills library, designed to bridge the gap between AI reasoning and official financial data sources.
Supporting a wide range of formats including VAT special invoices, electronic invoices, and the latest digital (all-electronic) invoices, this skill returns comprehensive metadata. This includes seller and purchaser details, tax breakdown, and itemized goods or services. Utilizing Openclaw Skills for financial automation allows developers to build agents that handle complex accounting tasks with high accuracy and minimal manual intervention.
Huisuiyun Invoice Verification Use Cases
- Automating the verification of VAT invoices for corporate expense management.
- Validating invoice authenticity during financial audits to prevent duplicate or fraudulent entries.
- Bulk processing of procurement records to sync verified tax data into ERP systems.
- Assisting small business owners in quickly checking the status of received electronic invoices.
How Huisuiyun Invoice Verification Works
- The AI agent or user gathers invoice details such as the invoice number, code, date, and amount.
- The skill processes these inputs and constructs a structured JSON request for the Huisuiyun API.
- The script authenticates using pre-configured AK/SK credentials to establish a secure connection.
- A verification request is sent to the Huisuiyun endpoint to cross-reference the invoice data with official records.
- The skill receives a detailed JSON response containing the verification status (valid/void/red-ink) and full invoice metadata.
- The results are parsed and presented in a developer-friendly format for further automation or reporting.
Huisuiyun Invoice Verification Setup
To use this skill within the Openclaw Skills framework, you must first configure your Huisuiyun API credentials as environment variables:
# Linux / macOS
export HSY_API_URL="https://huisuiyun.com"
export HSY_AK="your_ak_here"
export HSY_SK="your_sk_here"
export HSY_TYPE="2" # 1: ISV AK/SK, 2: Standard AK/SK
Ensure Python 3 is installed, then execute the script using the following syntax:
python3 skills/invoice-verify-hsy/invoice-verify-hsy.py verify '{"storeFlag":0,"invoiceList":[{"invoiceCode":"3300201130","invoiceNo":"00517731","amount":7559.41,"drewDate":"2021-06-22","invoiceType":"01"}]}'
Huisuiyun Invoice Verification Data Schema & Taxonomy
The skill returns a structured response containing status codes and detailed invoice objects.
| Parameter | Type | Description |
|---|---|---|
| code | String | Response status code (200 is success) |
| checkFlag | Boolean | Indicates if the invoice passed verification |
| invoiceVO | Object | Contains invoice details (type, code, number, date) |
| sellerName | String | Official name of the selling entity |
| amount | Decimal | Tax-exclusive amount or total amount depending on type |
| invoiceStatus | Integer | Status: 0-Normal, 1-Void, 2-Red Ink, etc. |
Huisuiyun Invoice Verification Advanced Features
- Batch processing capabilities allowing up to 20 invoices to be verified in a single request.
- Extensive support for various invoice types (01-VAT Special, 04-VAT Common, 09-Digital VAT Special, etc.).
- Intelligent error reporting that provides direct links to credential management for easy troubleshooting.
- Automatic handling of token-based authentication with 30-day validity cycles.
- Itemized detail extraction, providing granular data on goods and services within the invoice.
SKILL.md
Loading
Related Openclaw Skills
Codropshipping Product Search
A specialized tool for querying the Codrop shipping platform's product database via a simple keyword-based CLI interface.
Denmark AI Travel Planner
A specialized travel planning skill for Denmark that handles complex route logic, island logistics, and verified entry compliance.
Colombia Trip Planner
An AI agent skill for designing hyper-realistic, terrain-aware Colombian travel itineraries based on verified entry rules and regional playbooks.
Website Monitor
A professional monitoring tool that tracks website availability and generates daily visual performance reports.
Memorine
A pure Python and SQLite persistent memory layer that gives AI agents human-like capabilities like fact retention, event causal chains, and automatic forgetting.
8004: ERC-8004 Agent Trust Protocol
A decentralized trust infrastructure for AI agents to discover, identify, and verify each other across organizational boundaries on the Celo network.
METADATA
Featured*
