Wafeq API for Openclaw

A comprehensive API skill for managing Middle Eastern accounting, e-invoicing, and financial reporting via Wafeq.

yordilorenzo
v1.0.0
Feb 25, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install wafeq

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install wafeq 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 Wafeq API?

The Wafeq API skill provides a full-featured reference and integration toolset for the Wafeq platform, a leading accounting solution tailored for the Middle East, particularly the UAE and Saudi Arabia. It enables developers and automated agents to interact with the Wafeq REST API to manage every aspect of business finances, from generating standard and simplified tax invoices to tracking expenses and generating real-time financial reports. By utilizing Openclaw Skills, you can streamline your accounting workflows and ensure compliance with regional tax regulations through automated data processing and management.

Wafeq API Use Cases

  • Automating B2B and B2C e-invoicing for UAE and Saudi Arabian tax compliance.
  • Synchronizing e-commerce sales with Wafeq using bulk invoice creation endpoints.
  • Managing accounts payable by recording bills and expenses programmatically.
  • Generating real-time Profit & Loss or Balance Sheet reports for advanced data analysis.
  • Converting quotes into invoices and recording payments against outstanding balances automatically.

How Wafeq API Works

  1. Authenticate with the Wafeq platform using an API Key or OAuth2 token via the Openclaw Skills environment configuration.
  2. Identify the target resource such as contacts, accounts, or invoices using specific entity ID prefixes like cnt_ or inv_.
  3. Execute standard CRUD operations or specialized endpoints for tax authority reporting and PDF downloads.
  4. Utilize idempotency keys to ensure safe retries and prevent duplicate transactions in financial records.
  5. Process paginated results to sync large datasets like historical transactions or customer lists into your local environment.

Wafeq API Setup

To begin using this skill, obtain an API key from your Wafeq account settings. Set the environment variable in your terminal:

export WAFEQ_API_KEY='your-key-here'

Alternatively, you can configure the key within your local configuration file to enable Openclaw Skills to access the API:

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

Wafeq API Data Schema & Taxonomy

The skill organizes data through prefixed entity IDs and structured JSON payloads that follow regional accounting standards. Key resources include:

Resource ID Prefix Description
Contacts cnt_ Customer and vendor profiles
Accounts acc_ Chart of accounts and banking entries
Invoices inv_ Standard and simplified tax invoices
Bills bil_ Supplier invoices and recorded expenses
Payments pay_ Recorded payments against invoices

All responses from the Openclaw Skills integration include standard pagination metadata: count, next, previous, and results.

Wafeq API Advanced Features

  • Support for ZATCA and FTA compliant tax authority reporting for Saudi Arabia and UAE.
  • High-volume bulk invoice processing specifically designed for e-commerce platforms.
  • Idempotency support via X-Wafeq-Idempotency-Key for reliable transaction management in unstable network conditions.
  • Multi-branch and cost center support for complex organizational structures and multi-office accounting.
  • Direct PDF generation and download links for all financial documents including quotes and credit notes.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*