適用於 Openclaw 的 Wafeq API

一個全面的 API 技能,用於透過 Wafeq 管理中東地區的會計、電子發票和財務報告。

yordilorenzo
v1.0.0
Feb 25, 2026
0
0
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install wafeq

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 wafeq。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Wafeq API?

Wafeq API 技能為 Wafeq 平台提供了功能齊全的參考和整合工具集。Wafeq 是專門為中東(特別是阿聯酋和沙烏地阿拉伯)量身定制的領先會計解決方案。它使開發人員和自動化代理能夠與 Wafeq REST API 互動,以管理業務財務的各個方面,從生成標準和簡化的稅務發票到追蹤支出以及生成即時財務報表。透過利用 Openclaw Skills,您可以簡化會計工作流程,並透過自動化的數據處理和管理確保符合地區稅務法規。

Wafeq API 應用場景

  • 針對阿聯酋和沙烏地阿拉伯的稅務合規性,自動化 B2B 和 B2C 電子發票。
  • 使用批量發票創建接口,將電子商務銷售與 Wafeq 同步。
  • 透過程序化記錄帳單和支出,管理應付帳款。
  • 為高級數據分析生成即時的損益表或資產負債表。
  • 自動將報價單轉換為發票,並記錄未結餘額的付款。

Wafeq API 運作原理

  1. 透過 Openclaw Skills 環境配置,使用 API 金鑰或 OAuth2 令牌對 Wafeq 平台進行身份驗證。
  2. 使用特定的實體 ID 前綴(如 cnt_ 或 inv_)識別目標資源,例如聯絡人、帳戶或發票。
  3. 執行標準 CRUD 操作或專門用於稅務機關報告和 PDF 下載的接口。
  4. 利用冪等性金鑰確保安全重試,並防止財務記錄中的重複交易。
  5. 處理分頁結果,以將大型數據集(如歷史交易或客戶列表)同步到您的本地環境中。

Wafeq API 設定指南

要開始使用此技能,請從您的 Wafeq 帳戶設置中獲取 API 金鑰。在終端中設置環境變量:

export WAFEQ_API_KEY='your-key-here'

或者,您可以在本地配置文件中配置該金鑰,以啟用 Openclaw Skills 訪問 API:

{
  "skills": {
    "entries": {
      "wafeq-api": {
        "apiKey": "your-key-here"
      }
    }
  }
}

Wafeq API 資料結構與分類體系

該技能透過帶前綴的實體 ID 和遵循地區會計標準的結構化 JSON 有效負載來組織數據。主要資源包括:

資源 ID 前綴 描述
聯絡人 cnt_ 客戶和供應商檔案
帳戶 acc_ 會計科目表和銀行分錄
發票 inv_ 標準及簡化稅務發票
帳單 bil_ 供應商發票和記錄的支出
付款 pay_ 針對發票的已記錄付款

所有來自 Openclaw Skills 整合的響應都包含標準的分頁元數據:count、next、previous 和 results。

Wafeq API 進階特性

  • 支持針對沙烏地阿拉伯和阿聯酋的 ZATCA 和 FTA 合規稅務機關報告。
  • 專為電子商務平台設計的高交易量批量發票處理。
  • 透過 X-Wafeq-Idempotency-Key 支持冪等性,實現在不穩定網絡條件下的可靠交易管理。
  • 為複雜的組織結構和多辦公室會計提供多分支機構和成本中心支持。
  • 為包括報價單和折讓單在內的所有財務文件提供直接的 PDF 生成和下載鏈接。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Requires
Github Stars: 0
forks: 0

精選*