Skip to content
Qawafel logo

Qawafel integration

B2B marketplace and ZATCA-compliant document platform — sync products, orders, merchants and invoices with Saudi Arabia's leading wholesale network. Use Qawafel from Zoft voice agents, chat agents, workflows and AI employees.

  1. Starts withNew Order
  2. ZoftAgent or workflow decides what happens next
  3. Then in QawafelCreate Completed Order
  4. AndCreate Invoice
Illustrative flow built from Qawafel’s real triggers and actions.

Zoft + Qawafel

What Zoft can do with Qawafel.

  • 01Voice agentsA phone agent can use Qawafel actions such as Create Completed Order and Create Invoice during the call, then hand off to a person when it should.
  • 02Chat agentsThe same agent on web chat, WhatsApp or SMS can look up and update Qawafel while it talks to the customer.
  • 03WorkflowsStart a workflow when “New Order” happens in Qawafel, or use Qawafel as any step on the canvas.
  • 04AI employeesAn AI employee can find and use Qawafel actions on its own, and ask for your approval before it sends or changes anything important.

Actions 15

Things Zoft can do in Qawafel.

  • Get OrderFetch a single order by its Qawafel ID. Returns the full order including line items, totals, delivery details, and current state.
  • Get InvoiceFetch a single invoice by its Qawafel ID. Returns the full invoice including line items, totals, ZATCA PDF URL, and current state.
  • Get ProductFetch a single product by its Qawafel ID. Returns the full product including price, descriptions, and active status.
  • List OrdersGet orders, optionally filtered by status, customer, or creation date. Returns up to 500 orders (5 pages of 100).
  • Cancel OrderCancel an open order. Once cancelled, the order cannot be reopened — the only path forward is to create a new order.
  • Create Completed OrderSync a completed (fulfilled) order into Qawafel. Use this to import historical or externally-completed orders from another storefront, ERP, or B2B portal — the order is created directly in **Fulfilled** state and skips…
  • List InvoicesGet invoices, optionally filtered by status, customer, or creation date. Returns up to 500 invoices (5 pages of 100).
  • List ProductsGet products from your catalog, with optional filters by type, supplier, SKU, and active status. Returns up to 500 products (5 pages of 100).
  • Create InvoiceCreate an invoice in Qawafel for a customer. The invoice starts in `draft` state — use the **Generate Invoice** action (or call it from your dashboard) to finalize and issue a ZATCA-compliant copy.
  • Create ProductAdd a new product to your Qawafel catalog. The workhorse for catalog sync from your ERP or storefront into Qawafel.
Show all 15
  • Update ProductEdit a product's price, description, or active state. Only the fields you fill in are updated — leave the rest blank to keep them unchanged.
  • Create Merchant (Customer or Supplier)Add a new customer or supplier to your Qawafel tenant. Use this when onboarding a new B2B partner from your CRM, signup form, or another system.
  • Custom API CallMake a custom API call to a specific endpoint
  • Update MerchantEdit a merchant's trade name or active state. Only the fields you fill in are updated. (Legal name, CR, VAT and other identity fields cannot be changed via the API.)
  • Update Order StatusMove an order forward in the Qawafel fulfilment workflow. Qawafel enforces a strict state machine — for example, an order must be **Out for Delivery** before it can be marked **Delivered**. To cancel an order, use the *…

Triggers 8

Events in Qawafel that can start a workflow.

  • New OrderFires the moment a new sales order is created in Qawafel. Use it to fan out to fulfillment, accounting, Slack alerts, or your CRM.
  • New Invoice GeneratedFires when a ZATCA-compliant invoice is finalized in Qawafel (the `invoice.generated` event). Use it to email PDFs to customers, archive invoices to Drive, or push to your accounting system.
  • New Product PublishedFires when a new product is created in Qawafel. Use it to mirror your catalog into Shopify, Salla, Zid, or your data warehouse.
  • Invoice PaidFires when an invoice is marked as paid in Qawafel. Useful for posting payment receipts to Slack, releasing fulfilment, or syncing revenue to your books.
  • New Merchant RegisteredFires when a new merchant (customer or supplier) is created in Qawafel. Use it to onboard customers in your CRM or add suppliers to your procurement system.
  • Product UpdatedFires when a product is updated (price change, description edit, activated/deactivated). Use it to keep external storefronts in sync.
  • Refund / Credit Note CreatedFires when a credit note is created against an invoice (i.e. a customer return or refund is initiated). Use it to alert your finance team or trigger a return workflow.
  • Order Status ChangedFires when an order moves to a specific status (confirmed, out for delivery, delivered, fulfilled, cancelled, etc.). Pick one status per trigger — add the trigger again for additional statuses.

Setup

Connect Qawafel in three steps.

  1. 01ConnectChoose Qawafel in Connections and enter the account details Qawafel asks for, such as a store name or token.
  2. 02Put it to workAdd Qawafel as a workflow step, or let a voice agent, chat agent or AI employee use it as a tool.
  3. 03Review every runAdd approvals where you want a person in the loop. Every run leaves a record you can check.
See all in Commerce

FAQ

Qawafel on Zoft, answered.

What can Zoft do with Qawafel?

Zoft supports 15 actions and 8 triggers for Qawafel. You can use them as workflow steps, and voice agents, chat agents and AI employees can call them as tools.

How do I connect Qawafel to Zoft?

Choose Qawafel in Connections and enter the account details Qawafel asks for, such as a store name or token.

Can a voice agent or chat agent use Qawafel?

Yes. Once Qawafel is connected, a voice agent or chat agent can use its actions during a conversation. Permissions control which actions each agent can use.

Can an AI employee work in Qawafel without supervision?

Only as far as you allow. AI employees ask for approval before sensitive steps, and every run leaves a record you can review.

Put Qawafel to work in your operation.