ZATCA Phase 2 Ready • Secure Sandbox Access

Test Your E-Invoicing Integration with GSC FatooraX Sandbox

Connect your ERP, POS, billing, or accounting system to a secure sandbox built for invoice clearance, reporting workflows, XML validation, and API testing before production rollout.

Real-Time API Testing UBL 2.1 Validation QR Code Generation Enterprise Security
Sandbox Overview
Environment Active
Integration Mode API + XML Flexible onboarding for ERP and POS systems
Authentication Secure Token Controlled access for developers and teams
Compliance Focus ZATCA Phase 2 Clearance, reporting, and validation flows
Use Case Pre-Production Validate integrations before go-live
GSC FatooraX Sandbox helps implementation teams test invoice lifecycles, troubleshoot payloads, and streamline readiness for deployment.
Capabilities

Core Sandbox Capabilities

Built to support technical teams, ERP vendors, implementation partners, and enterprise customers working on e-invoicing integrations.

01

Invoice
Clearance API

Test real-time invoice clearance flows using secure integration endpoints designed for sandbox validation.

02

QR Code
Generation

Generate compliant QR codes for invoice testing and ensure correct output across supported invoice scenarios.

03

XML
Validation

Validate UBL 2.1 XML structures before production submission and identify formatting or schema issues early.

04

Secure Token Authentication

Access the sandbox using controlled authentication for safer testing, internal usage, and team-based access.

05

Reporting
Simulation

Verify reporting-oriented workflows for invoices, error handling, and status tracking within a controlled environment.

06

Developer-Friendly Testing

Accelerate implementation with payload validation, structured workflows, and a cleaner path to go-live readiness.

Why FatooraX

Why Use GSC FatooraX Sandbox?

A reliable environment for validating integrations, improving implementation confidence, and reducing production deployment risks.

Built for structured implementation teams

Use the sandbox to test invoice flows, validate XML, simulate connectivity, and prepare your business systems for a smoother production rollout.

Compliance-Oriented Testing
Supports implementation preparation for ZATCA-aligned e-invoicing workflows.
Enterprise Readiness
Suitable for ERP, POS, custom billing, and higher-volume invoice operations.
Reduced Go-Live Risk
Identify payload, validation, and integration issues before production deployment.
Faster Team Enablement
Help developers, analysts, and support teams align on consistent test scenarios.
Use Case ERP / POS / Billing Connect business systems to a controlled integration environment.
Testing Scope Clearance + Validation Support invoice generation, QR, XML, and submission validation flows.
Deployment Goal Production Readiness Move from sandbox to live implementation with better confidence.
Release Notes

Product Release History

Review feature additions, fixes, validations, UI enhancements, and backend improvements delivered across the GSC FatooraX platform.

V2.5.3
April 2026

Invoice Processing, DB Sync, Validation, and Integration Improvements

Minor Release • Click to view details

Overview

  • This release focuses on invoice data handling improvements, DB scheduler and synchronization enhancements, stronger validation, and better system logging.
  • It also improves API metadata handling, mapping validation, and frontend alignment for DB-related workflows.

Invoice Processing & Data Handling

  • Modified invoice creation flow to store Customer and Product data directly in Invoice and Invoice Line tables.
  • Removed dependency on separate Customer and Product table insertion during API, DB, and Excel uploads.
  • Ensured no new Customer or Product records are created when data is received from external sources.

DB Scheduler & Sync Enhancements

  • Implemented complete DB Pull flow for remote table synchronization.
  • Enabled scheduler-based automatic DB data dispatch and processing.
  • Improved staging-to-main data handling with proper error logging.
  • Allowed invoice acceptance in staging even when errors occur, with logs maintained.

Data Integrity & Validation

  • Enforced tax rate validation between header and line level across API, DB, Excel, and Form inputs.
  • Added unit validation for product data.
  • Standardized validation rules across all data ingestion sources.

API Enhancements

  • Implemented system-based “Created By” handling for API records.
  • Converted DB Admin ID to corresponding name format.
  • Ensured consistent metadata handling between API and DB entries.

Error Handling & Logging

  • Improved timeout logging mechanism.
  • Enhanced error tracking during DB sync and staging processes.

Mapping & Compliance

  • Implemented Standard B2B Mapping Validation.
  • Ensured consistent mapping during invoice ingestion.

UI & Integration Updates

  • Integrated updated HTML structure for DB-related flows.
  • Aligned frontend behavior with new DB pull and validation logic.
V2.5.2
March 2026

Dashboard, License Control, Upload Validation, and Usability Improvements

Minor Release • Click to view details

Overview

  • This release focuses on dashboard UI refinements, improved search capabilities, stricter data validation, and enhanced license-based access control.
  • It also introduces safeguards against duplicate uploads, enforces invoice upload limits, and improves overall system reliability and usability.

Dashboard & Interface Improvements

  • Fixed Footer Interface Status issue where Excel data movement was not reflected correctly.
  • Improved Weekly Filter Pending UI with thicker circle width and grey styling.
  • Set default dashboard filter to Weekly (All).
  • Fixed alignment issues in “This Month” filter.
  • Standardized PIE chart directions for consistency.

User & License Management

  • Implemented license-based user restriction; Add User is disabled when the license limit is reached.
  • Removed checkbox from License Management.
  • Fixed issue preventing the same user from logging in on multiple devices, ensuring license control even with shared 2FA.

Search & Usability Enhancements

  • Added search for Source on Dashboard.
  • Added search functionality for Supplier.
  • Enabled live typing (autocomplete) for Supplier and Customer Information.

Data Integrity & Validation

  • Restricted deletion of customers linked to CLEARED invoices.
  • Applied the same restriction for Products.
  • Improved the Create Invoice form with better visibility of required fields.

Pagination & Filtering Fixes

  • Fixed Customer List Pagination issues.
  • Improved Pending Data Filtering to apply correctly only on Invoice filter in Dashboard.

Notifications & Alerts

  • Added Database Connection Success Alert.

Invoice Upload Enhancements

  • Introduced a 5,000 invoice upload limit per file; the entire file will be rejected if the limit is exceeded, with a proper alert message displayed.
  • Implemented duplicate invoice handling where a text file is automatically downloaded containing duplicate records and reasons for rejection based on Excel issues.
V2.5.1
March 2026

UI, Dashboard, Search, and Business Logic Improvements

Click to view details

UI / UX Improvements

  • Updated chart color scheme for better clarity: Accepted/Cleared in green, Pending in yellow, and Rejected/Error in red.
  • Standardized the term ZATCA across the application and displayed it in full capital letters.
  • Redesigned the left sidebar menu with a clean white theme.
  • Improved spacing, alignment, and overall readability of the menu.
  • Reorganized menu items for smoother and more intuitive navigation.

Dashboard Enhancements

  • Improved donut charts with distinct colors for each status.
  • Enhanced visual consistency across dashboard widgets.
  • Improved readability and interaction with chart data.

Filters and Search

  • Added year-based search functionality in filters.
  • Added search by customer name for easier lookup.
  • Added search by invoice number for quick access to specific records.
  • Improved overall filtering options for better analysis and usability.

Business Logic Updates

  • Restricted deletion of customers linked to cleared invoices to ensure data integrity and compliance.
V2.5.0
March 2026

UI Consistency, Validation, Security, and Reporting Enhancements

Click to view details

Invoice Management

  • Improved the positioning of the Delete Invoice button for better accessibility.
  • Added a confirmation dialog to prevent accidental invoice deletion.

Navigation & UI Consistency

  • Updated “Api Configuration” to “API Configuration” for consistent capitalization.
  • Resolved naming inconsistency between “Upload Invoice” and “Upload Archived Invoice (ZIP)”.
  • Corrected breadcrumb hierarchy to match “Trash History”.
  • Standardized placeholder values across filters such as “Select Type”, “Select Invoice Type”, “Select Source”, and “Any”.

Database Configuration

  • Partially masked database server IP addresses in listings to reduce exposure of sensitive details.
  • Made Service Name mandatory for certain database types such as Oracle.
  • Added inline validation messages for required fields marked with (*).

License, User, and Permissions

  • Corrected “Licence No” to “License No” for terminology consistency.
  • Added clear password requirement guidance for users.
  • Restricted unauthorized editing of users assigned to the Admin role.
  • Improved permission count display to “31 / 50 Permissions Selected”.

Upload Archived Invoice Module

  • Added upload guidance for maximum file size, supported ZIP format, and accepted invoice structure.
  • Introduced a real-time upload progress indicator.
  • Resolved a JavaScript pending resource issue causing incomplete page loading.

VAT Summary Report & API Filtering

  • Removed automatic default PDF selection so users must explicitly choose export format.
  • Added mandatory Date From and Date To validation before exporting reports.
  • Prevented report generation when required filters are empty.
  • Apply button now requires at least one filter input before executing API requests.

Trash History

  • Improved UI feedback for Bulk Restore and Permanent Delete actions.
  • Clarified checkbox selection behavior for multi-record operations.
V2.4.0
February 2026

Validation, Reporting, API Configuration, and Usability Improvements

Click to view details

API Configuration Updates

  • Generate button renamed to Generate Key.
  • Header label updated to Authorization Key.

Invoice Management & Validation Improvements

  • Invoice product line validation now checks client-side before server validation triggers.
  • Restricted product add from Invoice Create UI.

CDN Removal / Asset Optimization

  • Eliminated CDN usage and moved dependencies to local/static assets wherever applicable.

Reporting & Export Enhancements

  • Updated reporting table: renamed current invoice_type column to type.
  • Added new invoice_type column for filtering B2B / B2C.
  • Updated export UI with new Invoice Type field.
  • Made Date From and Date To mandatory and enforced proper date range selection.
  • Updated status dropdown to use exact ZATCA status values.

Customer Selection UX Improvements

  • Moved Customer Name to dropdown.
  • Auto-prefilled Customer ID after customer selection.

UI / UX Fixes & Text Corrections

  • Total Amount and Total Amount (SAR) now display 0.00 by default.
  • Improved upload area helper text with supported file guidance.
  • Improved price input UI and currency alignment.
  • Marked Unit as mandatory and strengthened unit selection behavior.
  • Fixed onboarding heading grammar to “Please start onboarding.”

Company Management / View Mode Fixes

  • Removed YES button visibility if Production is already issued.
  • Fixed logo upload section behavior when a logo already exists.
  • Updated company document date display to DD/MM/YYYY.
  • Disabled file upload fields in view mode to prevent unintended changes.

Navigation & Search Fixes

  • Corrected mismatch between Navigation Title and Page Header.
  • Fixed Search button behavior returning incorrect “no match found”.
V2.3.0
February 2026

Backend Integrations, Upload Enhancements, UI Fixes, and Authentication Updates

Click to view details

Product & Customer Excel Enhancements

  • Added product download Excel format.
  • Added upload customer Excel format.
  • Implemented skip duplicate for product Excel upload.
  • Fixed product duplicate alert.
  • Implemented skip duplicate for customer Excel upload.
  • Fixed customer duplicate alert.
  • Fixed product sequence order by product code.
  • Fixed customer sequence order by customer code.

Customer & Invoice UI / Listing Improvements

  • Completed customer list filter.
  • Grouped Product / Customer / Invoice index menus by ID.
  • Updated all popups according to feature.
  • Added missing mandatory field asterisks (*).
  • Improved e-Invoicing form validation.
  • Required-field errors now auto-remove after valid input is entered.

Upload / Summary / Backend Integration

  • Completed upload interface summary backend integration and UI changes.
  • Completed rejected summary backend integration and UI changes.

API Configuration Changes

  • Completed API configuration design changes and backend integration.
  • Removed Server dropdown and kept single Base URL.
  • Removed right-side Download button.
  • Renamed label to Reporting Endpoints.
  • Renamed Authorize button to Create Authorization Key.
  • Added Create Authorization Key flow storing user email, key, and hash in authorization key table.

DB Connection Module Fixes

  • Completed DB connection alert and UI fixes.
  • Fixed DB connection PUT method error.
  • Added and fixed DB connection status and loader.

Dashboard & System UI Fixes

  • Completed dashboard graph alignment fixes.
  • Updated cursor to not-allowed on disabled Save Changes button in Company Details.
  • Fixed Trash History ID to show actual Customer/Product/etc. ID instead of row ID.

Authentication & Password Screens

  • Removed signup from login screen.
  • Removed social sign-in options.
  • Removed branding text from forgot password page footer.
  • Updated Login / 2FA / Forgot Password pages with new image.
V2.2.0
February 19, 2026

Dashboard Completion, Route Hardening, and Module Enhancements

Click to view details

Dashboard

  • Completed dashboard main page fully.
  • Added tooltips on dashboard counters.
  • Updated counter badge style and displayed real/live counters.
  • Replaced Invoice Status Overview with ZATCA Status Overview (Pending / Error / Fail).
  • Implemented dashboard graphs for Invoice Success, ZATCA Success, and Rejected / Error / Failed.

E-Invoice Module

  • Hidden Edit button when source = form and status = pending.
  • Removed B2B from subtype options when invoice main type = Simplified.
  • Replaced Send Invoice flow with Save & Send.
  • Fixed Bulk Print to download only one correct PDF with real data.
  • Updated PDF download filename to match invoice number.
  • Enhanced invoice list with AJAX pagination and improved ZATCA status filters.

Company, Product, and Customer Management

  • Completed Company module form and validation fixes.
  • Removed duplicate UI success messages and retained SweetAlert only.
  • Completed Product module fully.
  • Fixed Products empty-hit alert bug.
  • Added Download Excel format template for Products.
  • Enforced Product Name uniqueness.
  • Added Customer list filter.
  • Added Upload Customer Excel format template.
  • Added AJAX pagination and filters where required.

Licence Management

  • Completed Licence Management backend integration with new table support.

Routing and Middleware Hardening

  • Reviewed and regrouped routes.
  • Applied middleware consistently across all routes.
  • Updated routes file so auth + verified + 2FA middleware works correctly on protected routes.

API and System Versioning

  • Version displayed in Footer, Admin panel, and API Header.
  • API header example: X-App-Version: 2.2.0
  • Added configuration provision for client logo on dashboard via Settings.

Pending

  • Dashboard graph and counter alignment/layout fix pending and not part of this release.
V2.1.10
February 17, 2026

Invoice Notes Support, Product Validation Fixes, and UI Enhancements

Click to view details

Invoicing

  • Implemented unlimited Credit Note and Debit Note creation for Standard (B2B) and Simplified (B2C) invoices.
  • Enabled Credit/Debit Note support for Simplified (B2C) invoices.
  • Verified and tested Edit, Credit, and Debit workflows after Simplified invoice integration.
  • Re-tested the full invoice flow after recent updates to ensure stability and correctness.

Product Module

  • Products created with Inactive status now display correctly as Inactive in the product listing.
  • Resolved an issue where selecting Service as the unit was saved as Other and validated unit selection across all options.
  • Updated the VAT Rate label to include the “%” symbol.
  • Standardized field validations to align with the Add Product form.
  • Added mandatory field indicators (*) across relevant fields.
  • Validation error messages now clear automatically after valid input is provided.

UI and Pagination

  • Pagination page-size dropdown remains enabled even when total record count is lower than selected page size.
  • Implemented AJAX-based pagination and filtering with dynamic loading to avoid full page reloads.

Customer Module

  • Customer code is now auto-generated by the system, with edit option only in exceptional cases.
  • Customer Register Name has been made mandatory.

Messaging

  • Refined popup messages for clearer, more professional wording.
Get Access

Request GSC FatooraX Sandbox Credentials

Contact our integration team to receive sandbox credentials, API guidance, and onboarding support for your implementation team.

Contact Details

WhatsApp: +91 98602 56990
Product: GSC FatooraX Sandbox Environment
For production onboarding, API walkthroughs, and deployment support, please contact the GSC team.