Open API

The Open API allows businesses and developers to integrate directly with Fatoora using REST APIs.

This option is suitable for:

  • Custom systems
  • Middleware platforms

When to Use Open API

Use Open API if:

  • No prebuilt integration exists
  • Custom logic is required
  • You need full control over data flow
  • You are building middleware

Technical Overview

The API allows you to:

  • Create transactions (Invoices, Credit Notes, Debit Notes)
  • Submit documents for compliance
  • Check transaction status
  • Retrieve validation results

Authentication and request structure follow standard REST practices.

Integration Flow (API-Based)

  1. Authenticate with API credentials
  2. Create transaction payload
  3. Submit to Fatoora
  4. Retrieve response & compliance status

Responsibility Model

LayerResponsible Party
Data correctnessIntegrating system
Submission logicFatoora
Compliance validationZATCA
MonitoringUser / Partner

Best Practices

Professional Hint
  • Prefer prebuilt integrations when available
  • Use API only when necessary
  • Always validate test submissions before production
  • Monitor failed requests regularly

Related Topics