Get started

Introduction

The KWN API connects a company’s own systems — an ERP, a shop, a POS, a partner’s software — to its KWN account: sales and purchase documents, contacts and products, e-invoices cleared with the FTA, and the VAT reports.

What you can do

• Clear e-invoices. Send an invoice your system issued; KWN numbers it, files it in Sales and submits it to the FTA through Taxstar, its accredited provider. E-invoicing
• Run sales. Quotations, sales orders, invoices and credit notes, from draft to cleared.
• Run purchases. Requests for quotation, purchase orders, vendor bills and supplier refunds.
• Keep master data in step. One contact book for customers and vendors, and the product catalogue.
• Read the figures. The VAT 201 return and the ageing reports, as the app computes them.

How it works

Every request carries an API key that a company creates in Settings → Integrations → API keys. A key belongs to one company, reaches only that company’s records, and can do only what its scopes allow. The API is REST over HTTPS with JSON bodies, and every amount is in AED.

Base URL   https://app.kwn.tax/api/v1

The API reference is generated from the API’s own OpenAPI 3.0 document, so every route, field and example on it is the one the API answers with.

Where to start

• Quickstart: a key, a first call and a first e-invoice in five minutes.
• Authentication and Scopes: how a key proves who it is and what it may do.
• Connect a third-party system: for software companies connecting their customers’ KWN accounts.