Skip to main content

Quick Start Guide

Get up and running with Shaari in under 5 minutes. This guide walks you through the essential steps from account creation to uploading your first invoice.

Before You Begin

All you need is an email address and a web browser. Shaari works on desktop, tablet, and mobile. No software installation is required --- though you can install Shaari as a PWA for the best experience.


Step 1: Create Your Account

  1. Navigate to shaari.app in your browser.
  2. Click Sign Up (or إنشاء حساب in Arabic).
  3. Enter your email address and choose a password.
    • Passwords must be at least 8 characters and include uppercase, lowercase, and a number.
  4. Click Create Account.
  5. Check your email for a 6-digit verification code (OTP).
  6. Enter the OTP on the verification screen to activate your account.
Email Not Arriving?

Check your spam/junk folder. The email is sent from noreply@shaari.app. If it still does not arrive, click Resend Code to receive a new OTP.


Step 2: Complete Your Company Profile

After verifying your email, you will be prompted to set up your company profile. This information appears on your invoices and is required for ZATCA compliance.

  1. Company Name --- Enter your business name in Arabic and/or English.
  2. VAT Number --- Your 15-digit Saudi VAT registration number (starts and ends with 3).
  3. Commercial Registration (CR) Number --- Your 10-digit CR number from the Ministry of Commerce.
  4. Company Address --- Enter your business address. For Saudi businesses, this should follow the National Address format.
  5. Logo --- Upload your company logo (optional but recommended). It will appear on sales invoices and quotations.

Click Save to complete your profile.

Can I Update This Later?

Yes. All company profile fields can be updated at any time from Settings > Account. Your VAT and CR numbers are used for ZATCA e-invoice generation, so make sure they are accurate.


Step 3: Upload Your First Invoice

Now let's upload a purchase invoice to see Shaari's AI extraction in action.

  1. From the Dashboard, click the Upload Invoice button (or navigate to Purchases > Invoices).
  2. Click the upload area or drag-and-drop an invoice file.
    • Supported formats: PDF, JPEG, PNG, HEIC/HEIF
    • Maximum file size: 10 MB per file
  3. Shaari's AI engine will automatically process the document and extract:
    • Vendor name and VAT number
    • Invoice number and date
    • Line items, quantities, and amounts
    • Subtotal, VAT, and total
  4. Review the extracted data --- the AI is highly accurate, but you should verify the results. Make corrections if needed.
  5. Optionally assign a Category and Payment Type to organize your records.
  6. Click Save to store the invoice.
QR Code Detection

If your invoice contains a ZATCA-compliant QR code, Shaari will automatically detect and decode it, pre-filling vendor details and totals with verified data. Look for the green QR badge on the invoice card.


Step 4: Explore the Dashboard

After saving your first invoice, return to the Dashboard to see your data come to life.

  • Total Spending --- Your cumulative purchase total, updated in real time.
  • Monthly Chart --- A visual breakdown of spending over recent months.
  • Recent Invoices --- Quick access to your latest uploads.
  • Category Breakdown --- See how your expenses distribute across categories.

Take a moment to explore the sidebar navigation:

SectionWhat You'll Find
PurchasesAll uploaded purchase invoices, categories, payment types
SalesSales invoices, quotations, contracts, customers, products (Plus plan and above)
HREmployees, attendance, payroll, leave, custody (Enterprise plan)
ProjectsProject tracking, materials, expenses, subcontracts (Enterprise plan)
SettingsAccount, billing, ZATCA setup, automation, team management

What to Do Next

Now that you have your account set up and your first invoice uploaded, here are some recommended next steps:

Organize Your Invoices

Set Up Your Sales Pipeline (Plus Plan)

Configure Automation

Invite Your Team

Enable ZATCA Compliance (Enterprise Plan)

  • Configure ZATCA Phase 2 for e-invoice reporting.
  • Complete the onboarding wizard to connect your account to ZATCA's production environment.

Install as a PWA

  • On Chrome/Edge: Click the install icon in the address bar, or open the browser menu and select "Install Shaari."
  • On Safari (iOS): Tap the share button and select "Add to Home Screen."
  • Once installed, Shaari launches like a native app with its own window and icon.
Basic Plan Limitations

The Basic plan includes the Purchases module with full AI extraction, categories, and payment types. To access Sales, HR, Projects, or ZATCA integration, you will need to upgrade to Plus or Enterprise. See Plans & Billing for details.