โ† All skills
Tencent SkillHub ยท Developer Tools

Wafeq API Reference

Complete Wafeq accounting & e-invoicing API reference for the Middle East (UAE, Saudi Arabia). Use when building integrations with Wafeq, creating/managing i...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Complete Wafeq accounting & e-invoicing API reference for the Middle East (UAE, Saudi Arabia). Use when building integrations with Wafeq, creating/managing i...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, references/accounts-banking-contacts.md, references/bills-expenses-notes.md, references/core-concepts.md, references/enums.md, references/invoices.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.1.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 12 sections Open source page

Wafeq API Skill

Complete API reference for the Wafeq accounting and e-invoicing platform.

Setup

To use this skill, you need a Wafeq API key: Log in to Wafeq Go to Settings โ†’ API Keys (direct link) Create a new API key Set the environment variable: export WAFEQ_API_KEY='your-key-here' Or configure in ~/.openclaw/openclaw.json: { "skills": { "entries": { "wafeq-api": { "apiKey": "your-key-here" } } } } โš ๏ธ Security: Never hardcode your API key in code, prompts, or skill files. Always use the WAFEQ_API_KEY environment variable or configure it via skills.entries.wafeq-api.apiKey in ~/.openclaw/openclaw.json. You can validate your setup by running scripts/setup.sh from the plugin root.

Quick Reference

Base URL: https://api.wafeq.com/v1/ Auth (API Key): Authorization: Api-Key $WAFEQ_API_KEY โ€” get keys at https://app.wafeq.com/c/api-keys Auth (OAuth2): Authorization: Bearer <access_token> โ€” contact Wafeq for client credentials Idempotency: X-Wafeq-Idempotency-Key: <uuid-v4> on POST/PUT/PATCH/DELETE (1hr cache, replayed response includes X-Wafeq-Idempotent-Replayed: true) Pagination: ?page=1&page_size=25 โ€” response: { count, next, previous, results[] } Content-Type: application/json Currency codes: ISO 4217 (full list in references/enums.md) Entity IDs: Prefixed strings (e.g. cnt_..., acc_..., inv_...)

Standard CRUD Pattern

Most resources follow: POST /{resource}/, GET /{resource}/, GET /{resource}/{id}/, PUT /{resource}/{id}/, PATCH /{resource}/{id}/, DELETE /{resource}/{id}/. Some also have GET /{resource}/{id}/download/ for PDF. Line items are nested: /{resource}/{parent_id}/line-items/ with the same CRUD pattern.

Reference Files

FileContentsreferences/core-concepts.mdAuthentication (API Key + OAuth2), idempotency, error handling, quickstart guide, invoice creation walkthrough, use cases (B2B, B2C, e-commerce, expense management)references/enums.mdAll 18 enum types: currencies, statuses, classifications, tax types, discount types, languagesreferences/invoices.mdStandard invoices, invoice line items, bulk invoices (api-invoices), simplified invoices, simplified invoice line items โ€” full CRUD + schemasreferences/accounts-banking-contacts.mdChart of accounts, bank accounts, bank ledger transactions, bank statement transactions, contacts, beneficiaries โ€” full CRUD + schemasreferences/bills-expenses-notes.mdBills, bill line items, expenses, credit notes, credit note line items, bulk credit notes, debit notes, debit note line items โ€” full CRUD + schemasreferences/quotes-payments-remaining.mdQuotes, payments, payment requests, payslips, items, files, manual journals, journal line items, reports (balance sheet, P&L, cash flow, trial balance), organization, tax rates, branches, cost centers, employees, projects, warehouses โ€” full CRUD + schemas

Create and Send an Invoice

Create contact: POST /contacts/ Get revenue account: GET /accounts/?classification=REVENUE Get tax rates: GET /tax-rates/ Create invoice: POST /invoices/ (with line_items, contact, currency, invoice_date, invoice_due_date, invoice_number) Report to tax authority: POST /invoices/{id}/tax-authority/report/ Download PDF: GET /invoices/{id}/download/

Bulk Send Invoices (E-Commerce / High Volume)

POST /api-invoices/bulk_send/ with array of invoice objects including channels for email delivery Response: { "queued": N } Generate summary: GET /api-invoices/summary/

Record Expense

Get expense account: GET /accounts/?classification=EXPENSE Create expense: POST /expenses/ with paid_through_account, contact, date, currency, tax_amount_type, line_items

Record Payment Against Invoice

POST /payments/ with invoice_payments array linking to invoice IDs and amounts

Generate Financial Reports

Balance Sheet: GET /reports/balance-sheet/?currency=SAR&date=2025-12-31 Profit & Loss: GET /reports/profit-and-loss/?currency=SAR&date_after=2025-01-01&date_before=2025-12-31 Cash Flow: GET /reports/cash-flow/?currency=SAR&date_after=2025-01-01&date_before=2025-12-31 Trial Balance: GET /reports/trial-balance/?from_date=2025-01-01&to_date=2025-12-31

Quote to Invoice Conversion

Create quote: POST /quotes/ Convert to invoice: POST /quotes/{id}/invoice/

Important Notes

Tax authority reporting is available for invoices, simplified invoices, and credit notes via POST /{resource}/{id}/tax-authority/report/ Simplified invoices are for B2C transactions (no buyer tax registration required) Standard invoices are for B2B transactions Place of supply field is UAE-specific (emirate codes or OUTSIDE_UAE) Use reference fields as unique identifiers to prevent duplicate creation

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
6 Docs
  • SKILL.md Primary doc
  • references/accounts-banking-contacts.md Docs
  • references/bills-expenses-notes.md Docs
  • references/core-concepts.md Docs
  • references/enums.md Docs
  • references/invoices.md Docs