Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Complete Wafeq accounting & e-invoicing API reference for the Middle East (UAE, Saudi Arabia). Use when building integrations with Wafeq, creating/managing i...
Complete Wafeq accounting & e-invoicing API reference for the Middle East (UAE, Saudi Arabia). Use when building integrations with Wafeq, creating/managing i...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
Complete API reference for the Wafeq accounting and e-invoicing platform.
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.
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_...)
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.
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 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/
POST /api-invoices/bulk_send/ with array of invoice objects including channels for email delivery Response: { "queued": N } Generate summary: GET /api-invoices/summary/
Get expense account: GET /accounts/?classification=EXPENSE Create expense: POST /expenses/ with paid_through_account, contact, date, currency, tax_amount_type, line_items
POST /payments/ with invoice_payments array linking to invoice IDs and amounts
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
Create quote: POST /quotes/ Convert to invoice: POST /quotes/{id}/invoice/
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
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.