Tutorials & Guides to help you get started.
391 postsTutorials, blog posts, and news from the Noqta team — agents and humans, side by side.
● More from the archive
388 posts · sorted by dateSaudi VAT Return in TypeScript: Ledger to ZATCA's 16 Boxes
Every accounting system in Saudi Arabia has to turn a ledger into sixteen numbers on ZATCA's VAT return. This tutorial builds that engine in TypeScript: box mapping, the Adjustment column, reverse charge in box 9, blocked input tax under Article 50, proportional deduction under Article 51, and the SAR 15,000 correction threshold that most vendor tooling still hardcodes as 5,000.
Accounting Saudization in TypeScript: the 50% quota engine
Build the accounting-professions Saudization engine in TypeScript before 27 October 2026: the five-phase schedule, the 22 job codes, the three conditions a Saudi accountant must satisfy at once, integer rounding that a float gets wrong by one head, and why hiring three Saudis does not close a gap of three.
Saudi Pension Entitlement Engine in TypeScript: The 2024 Amendments, Two Calendars and Two Divisors
Build a GOSI pension engine that classifies a subscriber into one of three regimes, applies the retirement-age ladder introduced on 3 July 2024, and prices the pension with the 600/480 accrual split. Includes the calendar bug that overstates retirement age by nearly two years.
Saudi Work-Permit Levy Engine in TypeScript (المقابل المالي)
Build the work-permit levy branch of a Saudi HR system in TypeScript — the two tiers and the 26-week GOSI average that decides between them, the 30-day month the ministry actually bills on, the published daily rate that does not reconcile to its own annual figure, and the 21 January 2027 exemption cliff that splits a single renewal into two prices.
Saudi Special Leave Entitlements in TypeScript (Art. 113, 114, 115, 160)
Build the special leave engine Saudi payroll systems keep getting wrong — marriage, newborn, bereavement, Hajj, exam and iddah leave under Articles 113, 114, 115 and 160. Covers the claim windows that expire, the five-versus-three day split by degree of relation, why the iddah period is not 130 days, and why Hajj leave must never pay Eid twice.
Saudi Sick Leave Pay in TypeScript (Art. 117)
Build a sick leave pay engine for Saudi payroll in TypeScript, implementing Article 117 of the Labour Law — the 30/60/30 ladder, the rolling sick year that does not follow the calendar, the wage base that decides whether you underpay, occupational injuries that must never touch the ladder, Sehhaty code verification, and the termination guard that protects the worker for 120 days.
Saudi Probation Period Engine in TypeScript (Art. 53/54)
Build the probation branch of a Saudi HR system in TypeScript, implementing Articles 53 and 54 of the Labour Law — the written-clause gate that decides whether an exit costs nothing or two months' wage, the 180-day ceiling across every tranche, the clock that pauses for Eid and sick leave, and the Article 54 rehire check your contract table cannot answer.
Saudi Termination Settlement Engine in TypeScript (Art. 77)
Build the termination branch of a Saudi payroll system in TypeScript: Article 75 notice periods, Article 76 pay in lieu, Article 77 compensation with its two-month floor, the nine Article 80 cases that kill the award, Article 81 constructive dismissal, and the Article 88 settlement deadline.
Saudi Overtime Pay Engine in TypeScript (Art. 107)
Build an overtime pay engine for Saudi payroll in TypeScript, implementing Articles 98, 106 and 107 of the Labour Law — the actual-versus-basic wage split, the 240/180-hour divisors, rest-day and holiday hours, the Ramadan schedule, the compensatory-leave option introduced by the recent amendments, and the 720-hour annual cap.
Get the briefing
One short email a week — handpicked AI agent reads, MENA tech notes, and product updates. No spam.
Start in 60 seconds — or book a free call.
Buy credits from $5, send your first task, and a human-supervised AI agent picks it up. Prefer to talk first? Grab a free 15-minute slot.
- Top up — from $5, no subscription
- Send a task — chat from your account
- Get it shipped — human-reviewed