Wafeq API for Openclaw

A comprehensive Openclaw Skills integration for the Wafeq API, enabling automated accounting and e-invoicing for Middle Eastern businesses.

yordilorenzo
v1.1.0
Feb 25, 2026
0
930
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install wafeq-api

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-api 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 complete interface for the Wafeq accounting platform, specifically tailored for businesses operating in the UAE and Saudi Arabia. It allows AI agents to interact with every facet of the Wafeq ecosystem, from managing complex charts of accounts to handling mandatory tax authority reporting for e-invoices. By utilizing Openclaw Skills, developers can bridge the gap between their software applications and robust financial management systems, ensuring seamless compliance with local tax regulations like ZATCA and FTA.

This skill is essential for building sophisticated financial integrations that require more than just simple data entry. It supports full CRUD operations across multiple resources including contacts, bills, expenses, and manual journals. With built-in support for idempotency and standardized error handling, this Openclaw Skills resource ensures that financial operations remain reliable and consistent even in high-volume production environments.

Wafeq API Use Cases

  • Automating B2B and B2C invoice generation for e-commerce platforms using Openclaw Skills.
  • Synchronizing bank statements and ledger transactions for real-time financial tracking and reconciliation.
  • Generating and exporting regional financial reports like P&L and Balance Sheets via Openclaw Skills.
  • Recording business expenses and managing vendor bills through automated AI workflows.
  • Managing Middle East specific tax compliance and automated e-invoice reporting to local authorities.

How Wafeq API Works

  1. The user authenticates the session using a Wafeq API key stored in the environment or the Openclaw Skills configuration file.
  2. The agent identifies the required financial resource, such as invoices, contacts, or ledger accounts, based on the prompt.
  3. The skill executes RESTful API calls to Wafeq's v1 endpoints, automatically handling headers and JSON payloads.
  4. Idempotency keys are managed to prevent duplicate transactions during retries or multi-step processes.
  5. Financial data is processed, such as converting a quote into a final invoice or reporting a transaction to the tax authority.
  6. The skill returns structured JSON responses or PDF download links for the requested financial documents to the agent.

Wafeq API Setup

To use this skill, obtain your API key from the Wafeq dashboard settings. Then, configure your environment using the following command:

export WAFEQ_API_KEY='your-key-here'

Alternatively, you can add the key to your Openclaw Skills configuration file at ~/.openclaw/openclaw.json:

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

Wafeq API Data Schema & Taxonomy

The skill organizes data into several core resource types, each identified by a unique ID prefix for easy classification within Openclaw Skills.

Resource ID Prefix Purpose
Contacts cnt_ Managing customer and vendor records
Accounts acc_ General ledger and bank account definitions
Invoices inv_ Standard (B2B) and simplified (B2C) e-invoices
Bills bil_ Tracking vendor invoices and business expenses
Payments pay_ Recording payments against specific invoices

Metadata includes idempotency tracking via X-Wafeq-Idempotency-Key and strict adherence to ISO 4217 currency codes and Middle East tax classifications.

Wafeq API Advanced Features

  • Idempotent request handling using UUID v4 keys to ensure transaction safety within Openclaw Skills.
  • Built-in support for ZATCA and FTA e-invoicing reporting directly from the API.
  • High-volume bulk invoice processing for large-scale e-commerce operations via specialized bulk endpoints.
  • Automated quote-to-invoice conversion workflows that preserve data integrity.
  • Real-time generation of complex financial reports including trial balance and cash flow statements.
  • Support for multi-branch, cost center, and project-based accounting structures.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*