écrits/tutorial/2026/11
● Tutorial20 nov. 2026·20 min

Saoudisation à 100 % de l'appui administratif : audit TypeScript

La décision 132249 réserve 69 métiers d'appui administratif aux Saoudiens : 19 depuis le 5 avril 2026 et 50 depuis le 4 octobre 2026, dès le premier salarié. Construisez l'audit en TypeScript : la liste des codes en données, les tâches exercées sous d'autres intitulés, la date de début de chaque infraction et un plan lisible par les RH.

Le 5 avril 2026, le ministère saoudien des Ressources humaines et du Développement social a publié la décision ministérielle 132249 et un guide de procédure mis à jour pour les métiers d'appui administratif. Elle réserve 69 métiers aux Saoudiens à 100 %. Dix-neuf s'appliquent depuis la date de publication. Les cinquante autres s'appliquent depuis le 4 octobre 2026, à la fin du délai de grâce de six mois, date à laquelle le ministère a annoncé le début des inspections.

La plupart des décisions de saoudisation posent un problème de comptage : un taux, un seuil, une règle d'arrondi. Pas celle-ci. À 100 %, sans effectif minimum, il n'y a rien à arrondir. Un seul réceptionniste non saoudien dans une seule succursale met toute l'entité en défaut. La question n'est plus « combien de Saoudiens nous faut-il ? » mais « qui est en infraction, depuis quand, et l'infraction est-elle dans le dossier ou dans le travail réel ? »

Ce tutoriel construit cet audit en TypeScript, à partir du guide du ministère, avec des tests exécutables. Il s'adresse au développeur ou au responsable des systèmes RH qui doit produire la liste avant que l'inspecteur ne le fasse.

Prérequis

  • Node.js 20 ou plus récent et TypeScript 5
  • Un export des effectifs avec, pour chaque salarié : la nationalité, le code de métier enregistré auprès de la GOSI, la succursale, l'entité et la date de début de son poste actuel
  • Une courte liste de tâches par personne, fournie par les responsables directs. C'est la colonne qui révèle les cas coûteux, et aucun système RH ne la contient aujourd'hui
  • Une connaissance de base de Qiwa, de la GOSI et de Nitaqat

Ce que vous allez construire

Un petit module qui répond à quatre questions pour chaque entité :

  1. Qui est enregistré sous l'un des 69 codes, et lesquels ne sont pas saoudiens ?
  2. Qui exerce le travail d'un métier saoudisé sous un autre intitulé ?
  3. Pour chaque infraction, à partir de quelle date compte-t-elle : celle de la décision ou celle de la prise de poste ?
  4. Que doivent faire les RH pour chaque personne : remplacer, réaffecter ou corriger un dossier ?

Le résultat est une liste de lignes simples, classées par niveau de risque.

Étape 1 : ce que dit réellement le guide

Tout ce qui suit vient du guide de procédure de sept pages de la décision 132249, publié sur le site du ministère. Nous avons lu les tableaux sur les images des pages, pas sur le texte extrait, car le PDF mélange les colonnes.

Le taux. Le travail dans les métiers visés est réservé aux Saoudiens à 100 %, au niveau de l'entité (section 3.1).

Le champ. La section 3.2 applique la décision à tout établissement privé du marché saoudien qui emploie un salarié ou plus dans les métiers d'appui administratif du tableau 1. Il n'y a pas de seuil à modéliser. À comparer avec la décision sur la comptabilité, qui commence à cinq, ou celle sur les achats, à trois.

L'entité. Les définitions décrivent l'entité comme la qualité sous laquelle le ministère traite avec l'entreprise pour le calcul de la saoudisation, et qui regroupe toutes les succursales d'une même activité économique détenues par un même établissement. La succursale n'est pas l'unité de conformité.

Les métiers. Le tableau 1 liste 69 codes de la classification saoudienne unifiée des métiers. La section 4.3 les répartit par date :

TableauCodesEn vigueur
Tableau 2195 avril 2026, date de publication
Tableau 3504 octobre 2026, après un délai de grâce de six mois

Les 19 codes immédiats comprennent les traducteurs, les secrétaires, les agents de saisie, les agents de sécurité, les magasiniers, les déclarants en douane et le trésorier. Les 50 codes suivants relèvent surtout des RH et des relations publiques : responsables et spécialistes du recrutement, de la rémunération, de la planification des effectifs et du protocole, plus le réceptionniste, l'assistant administratif et le chargé des relations avec l'administration. Notre article d'actualité sur la décision les cite tous les 69. Dans le code ci-dessous, les codes font foi et les intitulés anglais sont notre traduction.

Chevauchement. Si une décision antérieure ou postérieure vise l'un de ces métiers à un taux différent, le taux le plus élevé s'applique (section 3.2). Comme 100 % est le plafond, cette décision l'emporte sur tout code qu'elle partage avec une autre, à partir de sa propre date d'entrée en vigueur.

Sanctions. La section 5 applique les infractions de saoudisation prévues par la décision ministérielle 75913 (19/5/1445 H) et la décision ministérielle 44558 (3/4/1446 H), telles que modifiées. Elle nomme deux infractions : ne pas atteindre le taux, et confier une tâche d'un métier saoudisé à un salarié non saoudien « directement ou indirectement » sous tout autre intitulé.

La FAQ ajoute trois points qui façonnent le code :

  • La décision s'applique quelle que soit la bande Nitaqat de l'établissement. La bande n'influe pas sur le calcul et ne protège pas de la sanction.
  • Elle s'applique aux intitulés classés dans la classification saoudienne unifiée des métiers et au travail réellement exercé par le salarié.
  • Le contrôle est automatique. Le système applique la formule aux intitulés de la base de la GOSI, puis vérifie les salaires et l'accréditation professionnelle par ses liaisons avec les autorités de tutelle.

Le guide ne fixe aucun salaire minimum pour qu'un Saoudien soit compté dans ces métiers. Il liste en revanche des aides pour les employeurs : aide à la recherche de candidats, soutien à la formation, soutien à l'embauche et à la stabilité, et accès prioritaire aux programmes de saoudisation du ministère.

Étape 2 : la liste des codes en données

Gardez la liste dans un seul enregistrement, avec le tableau auquel appartient chaque code. La date d'effet découle du tableau, si bien qu'un code ne peut jamais porter une mauvaise date.

// src/rules.ts
// Decision 132249 (5 April 2026), procedural guide tables 2 and 3.
// Codes are from the Saudi Unified Classification of Occupations.
// The English titles and the groups are our own translation and grouping.
export type Group =
  | "hr" | "pr" | "front-office" | "clerical"
  | "language" | "security" | "logistics" | "finance";
 
export interface Occupation {
  title: string;
  group: Group;
  table: 2 | 3;
}
 
export const DECISION = "132249";
export const RATE_PERCENT = 100;
export const MIN_WORKERS = 1;
 
// Table 2 applies from the date of issue, table 3 after six months.
export const EFFECTIVE: Record<2 | 3, string> = {
  2: "2026-04-05",
  3: "2026-10-04",
};
 
export const OCCUPATIONS: Record<string, Occupation> = {
  // Table 2: in force from 5 April 2026 (19 codes)
  "264301": { title: "Translator", group: "language", table: 2 },
  "264302": { title: "Simultaneous interpreter", group: "language", table: 2 },
  "264305": { title: "Linguist", group: "language", table: 2 },
  "541402": { title: "Security guard", group: "security", table: 2 },
  "541403": { title: "Personal guard", group: "security", table: 2 },
  "441601": { title: "HR clerk", group: "hr", table: 2 },
  "121208": { title: "Personnel relations manager", group: "hr", table: 2 },
  "121211": { title: "Labour affairs manager", group: "hr", table: 2 },
  "441401": { title: "Copyist", group: "clerical", table: 2 },
  "412002": { title: "Secretary", group: "clerical", table: 2 },
  "334301": { title: "Executive secretary", group: "clerical", table: 2 },
  "413101": { title: "Stenographer", group: "clerical", table: 2 },
  "413201": { title: "Data entry clerk", group: "clerical", table: 2 },
  "422401": { title: "Hotel receptionist", group: "front-office", table: 2 },
  "422502": { title: "Complaints clerk", group: "front-office", table: 2 },
  "422602": { title: "Patient reception clerk", group: "front-office", table: 2 },
  "432101": { title: "Storekeeper", group: "logistics", table: 2 },
  "333103": { title: "Customs clearance agent", group: "logistics", table: 2 },
  "241104": { title: "Treasurer", group: "finance", table: 2 },
 
  // Table 3: in force from 4 October 2026 (50 codes)
  "121201": { title: "HR operations manager", group: "hr", table: 3 },
  "121202": { title: "Workforce planning manager", group: "hr", table: 3 },
  "121203": { title: "Occupational classification manager", group: "hr", table: 3 },
  "121204": { title: "Hiring manager", group: "hr", table: 3 },
  "121205": { title: "Compensation manager", group: "hr", table: 3 },
  "121206": { title: "Talent manager", group: "hr", table: 3 },
  "121207": { title: "HR development manager", group: "hr", table: 3 },
  "121209": { title: "Recruitment office manager", group: "hr", table: 3 },
  "121210": { title: "Labour office manager", group: "hr", table: 3 },
  "121212": { title: "Civil service office manager", group: "hr", table: 3 },
  "121213": { title: "Institutional development manager", group: "hr", table: 3 },
  "121214": { title: "Administrative organisation manager", group: "hr", table: 3 },
  "121215": { title: "Administrative investigation manager", group: "hr", table: 3 },
  "121216": { title: "Cybersecurity HR manager", group: "hr", table: 3 },
  "242301": { title: "Job placement specialist", group: "hr", table: 3 },
  "242302": { title: "HR operations specialist", group: "hr", table: 3 },
  "242303": { title: "Job classification specialist", group: "hr", table: 3 },
  "242304": { title: "Hiring specialist", group: "hr", table: 3 },
  "242305": { title: "Compensation specialist", group: "hr", table: 3 },
  "242306": { title: "Career guidance specialist", group: "hr", table: 3 },
  "242307": { title: "Labour investigator", group: "hr", table: 3 },
  "242308": { title: "Labour committee member", group: "hr", table: 3 },
  "242309": { title: "Workforce planning specialist", group: "hr", table: 3 },
  "242310": { title: "HR monitoring specialist", group: "hr", table: 3 },
  "242311": { title: "Recruitment specialist", group: "hr", table: 3 },
  "242312": { title: "HR consultant", group: "hr", table: 3 },
  "242313": { title: "HR expert", group: "hr", table: 3 },
  "122203": { title: "Public relations manager", group: "pr", table: 3 },
  "122205": { title: "Fundraising manager", group: "pr", table: 3 },
  "122206": { title: "Protocol manager", group: "pr", table: 3 },
  "243202": { title: "Public relations specialist", group: "pr", table: 3 },
  "243204": { title: "Internal communication specialist", group: "pr", table: 3 },
  "243205": { title: "Public awareness specialist", group: "pr", table: 3 },
  "243206": { title: "Conference and events specialist", group: "pr", table: 3 },
  "243207": { title: "Protocol specialist", group: "pr", table: 3 },
  "243208": { title: "Public relations consultant", group: "pr", table: 3 },
  "243209": { title: "Public relations expert", group: "pr", table: 3 },
  "422501": { title: "Enquiries clerk", group: "front-office", table: 3 },
  "422601": { title: "Receptionist", group: "front-office", table: 3 },
  "411001": { title: "Government relations clerk", group: "clerical", table: 3 },
  "411002": { title: "Registry clerk", group: "clerical", table: 3 },
  "412001": { title: "Administrative assistant", group: "clerical", table: 3 },
  "413102": { title: "Typist", group: "clerical", table: 3 },
  "264303": { title: "Proofreader", group: "language", table: 3 },
  "264304": { title: "Sign language interpreter", group: "language", table: 3 },
  "541401": { title: "Security camera monitor", group: "security", table: 3 },
  "333101": { title: "Freight agent", group: "logistics", table: 3 },
  "333102": { title: "Customs agent", group: "logistics", table: 3 },
  "432102": { title: "Shipping clerk", group: "logistics", table: 3 },
  "432103": { title: "Stock movement clerk", group: "logistics", table: 3 },
};
 
export function effectiveFrom(code: string): string | undefined {
  const o = OCCUPATIONS[code];
  return o ? EFFECTIVE[o.table] : undefined;
}
 
export function inForce(code: string, onDate: string): boolean {
  const from = effectiveFrom(code);
  return from !== undefined && from <= onDate;
}

Le champ group est notre propre regroupement. Le guide donne un seul tableau, sans services. Nous l'ajoutons parce qu'un rapport qui dit « onze codes RH, trois à l'accueil » indique aux RH où chercher, et parce que trouver un remplaçant pour un spécialiste du recrutement et pour un opérateur de vidéosurveillance sont deux recherches très différentes.

La comparaison from <= onDate porte sur des dates ISO sous forme de chaînes. Leur ordre alphabétique est l'ordre chronologique, ce qui évite tout problème de fuseau horaire.

Étape 3 : les tâches, pas seulement les intitulés

Le système lit les intitulés de la GOSI. L'inspecteur lit le travail. Le guide fait de ce second cas une infraction à part entière, et c'est celui que vos données ne montrent pas : un « chargé des opérations » non saoudien qui suit les dossiers de l'entreprise auprès des administrations fait le travail d'un chargé des relations avec l'administration ; un « coordinateur de bureau » qui accueille les visiteurs et répond au téléphone fait celui d'un réceptionniste.

Pour le voir, il faut une donnée de plus par personne : ce qu'elle fait réellement. Nous demandons aux responsables de cocher des tâches dans une liste fixe, et nous relions chaque tâche au métier saoudisé dont elle relève.

// src/duties.ts
// Duties a line manager can tick for each person, mapped to the localised
// occupation they belong to. This mapping is ours, not the guide's: extend it
// with the duties your own organisation hands out under other titles.
export type Duty =
  | "reception" | "enquiries" | "complaints" | "government-relations"
  | "data-entry" | "typing" | "secretarial" | "admin-assistance"
  | "translation" | "proofreading" | "recruitment" | "compensation"
  | "guarding" | "cctv-monitoring" | "storekeeping" | "stock-movement"
  | "shipping-documents" | "customs-clearance" | "cash-custody"
  | "public-relations" | "events";
 
export const DUTY_TO_CODE: Record<Duty, string> = {
  "reception": "422601",
  "enquiries": "422501",
  "complaints": "422502",
  "government-relations": "411001",
  "data-entry": "413201",
  "typing": "413102",
  "secretarial": "412002",
  "admin-assistance": "412001",
  "translation": "264301",
  "proofreading": "264303",
  "recruitment": "242311",
  "compensation": "242305",
  "guarding": "541402",
  "cctv-monitoring": "541401",
  "storekeeping": "432101",
  "stock-movement": "432103",
  "shipping-documents": "432102",
  "customs-clearance": "333103",
  "cash-custody": "241104",
  "public-relations": "243202",
  "events": "243206",
};

Cette correspondance est un jugement, et c'est le nôtre. Le guide ne définit pas de tâches ; il s'appuie sur la classification. Commencez par ces 21 tâches, qui couvrent les rôles le plus souvent confiés sous d'autres intitulés, puis ajoutez celles de votre organisation. Un test de l'étape 6 vérifie que chaque tâche pointe toujours vers un code de la décision.

Étape 4 : classer chaque salarié

Un salarié peut apparaître de quatre façons, et chacune appelle une correction différente :

StatutQuiCorrection
breach-registeredNon-Saoudien sous un code saoudisé, qui fait ce travailRemplacer, ou réaffecter et changer le code
breach-disguisedNon-Saoudien qui fait un travail saoudisé sous un autre codeLui retirer ces tâches
code-onlyNon-Saoudien sous un code saoudisé, qui fait un autre travailCorriger le dossier GOSI
saudi-wrong-codeSaoudien qui fait un travail saoudisé sous un autre codeEnregistrer le bon code

Le dernier cas n'est pas une infraction. À 100 %, un Saoudien ne crée jamais d'écart, mais une réceptionniste saoudienne enregistrée sous un autre intitulé reste une incohérence que l'inspecteur relèvera, et la corriger ne coûte rien.

// src/assess.ts
import { effectiveFrom, inForce } from "./rules";
import { Duty, DUTY_TO_CODE } from "./duties";
 
export interface Worker {
  id: string;
  entityId: string;       // the establishment as the ministry groups it
  branchId: string;
  saudi: boolean;
  occupationCode: string; // as registered with GOSI
  duties: Duty[];         // what the person actually does, from the line manager
  inRoleSince: string;    // ISO date the person started this work
}
 
export type Status =
  | "ok"
  | "breach-registered" // non-Saudi under a localised code that does the work
  | "code-only"         // non-Saudi under a localised code, work is different
  | "breach-disguised"  // non-Saudi doing localised work under another code
  | "saudi-wrong-code"; // Saudi doing localised work under another code
 
export interface Finding {
  workerId: string;
  status: Exclude<Status, "ok">;
  codes: string[];      // the localised codes involved
  breachSince?: string; // when the system starts counting it against you
}
 
function laterOf(a: string, b: string): string {
  return a > b ? a : b;
}
 
export function assessWorker(w: Worker, onDate: string): Finding | undefined {
  const registered = inForce(w.occupationCode, onDate);
  const dutyCodes = [
    ...new Set(w.duties.map((d) => DUTY_TO_CODE[d]).filter((c) => inForce(c, onDate))),
  ].sort();
 
  if (w.saudi) {
    // At 100% a Saudi never creates a gap, but the GOSI record should match the work.
    if (!registered && dutyCodes.length > 0) {
      return { workerId: w.id, status: "saudi-wrong-code", codes: dutyCodes };
    }
    return undefined;
  }
 
  if (registered) {
    const doesTheWork = w.duties.some((d) => DUTY_TO_CODE[d] === w.occupationCode);
    const others = dutyCodes.filter((c) => c !== w.occupationCode);
    if (!doesTheWork && others.length === 0) {
      // The system still counts the GOSI title. Fix the record if the job differs.
      return {
        workerId: w.id,
        status: "code-only",
        codes: [w.occupationCode],
        breachSince: laterOf(effectiveFrom(w.occupationCode)!, w.inRoleSince),
      };
    }
    return {
      workerId: w.id,
      status: "breach-registered",
      codes: [...new Set([w.occupationCode, ...others])].sort(),
      breachSince: laterOf(effectiveFrom(w.occupationCode)!, w.inRoleSince),
    };
  }
 
  if (dutyCodes.length > 0) {
    const earliest = dutyCodes.map((c) => effectiveFrom(c)!).sort()[0];
    return {
      workerId: w.id,
      status: "breach-disguised",
      codes: dutyCodes,
      breachSince: laterOf(earliest, w.inRoleSince),
    };
  }
  return undefined;
}

Trois choix de cette fonction méritent une explication.

code-only compte quand même. Le système calcule à partir de l'intitulé GOSI : un non-Saoudien enregistré comme agent de saisie est compté contre vous même s'il gère en réalité l'entrepôt. Nous en faisons un statut distinct, parce que la correction est une mise à jour de dossier et non une embauche, mais nous lui donnons une date de début comme à toute infraction.

Une infraction commence à la plus tardive de deux dates. Une secrétaire embauchée en 2023 est en infraction depuis le 5 avril 2026. Un agent de sécurité embauché le 1er septembre 2026 l'est depuis sa prise de poste. C'est le chiffre à placer à côté de chaque nom.

Les tâches pas encore en vigueur sont ignorées. Avant le 4 octobre 2026, un non-Saoudien qui assurait l'accueil sous un autre intitulé n'était pas en infraction, car l'accueil relève du tableau 3. Le filtre inForce garde les rapports des dates antérieures exacts.

Étape 5 : le rapport par entité et le plan

Regroupez par entité, jamais par succursale. Comptez ce que le système compterait, c'est-à-dire toute personne sous un code saoudisé en vigueur, puis ajoutez les constats.

// src/report.ts
import { OCCUPATIONS, Group, inForce } from "./rules";
import { Worker, Finding, assessWorker } from "./assess";
 
export interface EntityReport {
  entityId: string;
  onDate: string;
  inScope: number;    // workers registered under a localised code in force
  saudis: number;
  required: number;   // at 100%, everyone in scope
  gap: number;        // non-Saudis to move or replace
  byGroup: Partial<Record<Group, { inScope: number; nonSaudi: number }>>;
  findings: Finding[];
  breachDays: number; // sum over breaches, in worker-days
}
 
export function daysBetween(from: string, to: string): number {
  return Math.round((Date.parse(to) - Date.parse(from)) / 86_400_000);
}
 
export function reportEntity(entityId: string, workers: Worker[], onDate: string): EntityReport {
  const mine = workers.filter((w) => w.entityId === entityId);
  const scoped = mine.filter((w) => inForce(w.occupationCode, onDate));
  const byGroup: EntityReport["byGroup"] = {};
  for (const w of scoped) {
    const g = OCCUPATIONS[w.occupationCode].group;
    const slot = (byGroup[g] ??= { inScope: 0, nonSaudi: 0 });
    slot.inScope += 1;
    if (!w.saudi) slot.nonSaudi += 1;
  }
  const findings = mine
    .map((w) => assessWorker(w, onDate))
    .filter((f): f is Finding => f !== undefined);
  const breachDays = findings.reduce(
    (sum, f) => sum + (f.breachSince ? Math.max(0, daysBetween(f.breachSince, onDate)) : 0),
    0,
  );
  const saudis = scoped.filter((w) => w.saudi).length;
  return {
    entityId,
    onDate,
    inScope: scoped.length,
    saudis,
    required: scoped.length,
    gap: scoped.length - saudis,
    byGroup,
    findings,
    breachDays,
  };
}

À 100 %, required est égal à inScope et gap est simplement le nombre de non-Saoudiens dans le champ. Nous gardons les deux champs pour que le rapport ait la même forme que les autres contrôles de saoudisation et puisse figurer dans le même tableau de bord.

breachDays additionne les jours de toutes les infractions. Ce n'est pas une amende : le guide renvoie aux barèmes de sanctions sans montants, et nous n'en inventons pas. C'est un moyen de voir si l'exposition augmente ou diminue d'un mois à l'autre.

Les RH ne lisent pas des objets. La dernière étape transforme donc le rapport en lignes, les infractions enregistrées en premier :

// src/plan.ts
import { OCCUPATIONS } from "./rules";
import { EntityReport, daysBetween } from "./report";
 
function titles(codes: string[]): string {
  return codes.map((c) => `${OCCUPATIONS[c].title} (${c})`).join(", ");
}
 
export function actionPlan(r: EntityReport): string[] {
  const lines = [
    `Entity ${r.entityId} on ${r.onDate}: ${r.saudis}/${r.inScope} Saudi in localised codes, ` +
      `${r.gap} to move or replace.`,
  ];
  const order = { "breach-registered": 0, "breach-disguised": 1, "code-only": 2, "saudi-wrong-code": 3 };
  const sorted = [...r.findings].sort(
    (a, b) => order[a.status] - order[b.status] || a.workerId.localeCompare(b.workerId),
  );
  for (const f of sorted) {
    const since = f.breachSince ? `, ${daysBetween(f.breachSince, r.onDate)} days since ${f.breachSince}` : "";
    switch (f.status) {
      case "breach-registered":
        lines.push(`${f.workerId}: non-Saudi in ${titles(f.codes)}${since}. Replace, or move to other work and change the code.`);
        break;
      case "breach-disguised":
        lines.push(`${f.workerId}: non-Saudi doing ${titles(f.codes)} under another title${since}. Remove these duties.`);
        break;
      case "code-only":
        lines.push(`${f.workerId}: registered as ${titles(f.codes)} but does other work${since}. Correct the GOSI record.`);
        break;
      case "saudi-wrong-code":
        lines.push(`${f.workerId}: Saudi doing ${titles(f.codes)} under another code. Register the right code.`);
        break;
    }
  }
  return lines;
}

Tester votre implémentation

Ces tests fixent ce que dit le guide : les 69 codes et leur répartition, les deux dates, le seuil d'un salarié, la règle de l'entité et les quatre statuts. Lancez-les avec npx tsx --test src/audit.test.ts.

// src/audit.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { OCCUPATIONS, EFFECTIVE, inForce } from "./rules";
import { DUTY_TO_CODE } from "./duties";
import { Worker, assessWorker } from "./assess";
import { reportEntity, daysBetween } from "./report";
import { actionPlan } from "./plan";
 
const w = (id: string, saudi: boolean, code: string, extra: Partial<Worker> = {}): Worker => ({
  id, entityId: "E1", branchId: "B1", saudi, occupationCode: code,
  duties: [], inRoleSince: "2024-01-01", ...extra,
});
 
test("the guide lists 69 codes: 19 in table 2 and 50 in table 3", () => {
  const codes = Object.keys(OCCUPATIONS);
  assert.equal(codes.length, 69);
  assert.equal(codes.filter((c) => OCCUPATIONS[c].table === 2).length, 19);
  assert.equal(codes.filter((c) => OCCUPATIONS[c].table === 3).length, 50);
  assert.ok(codes.every((c) => /^\d{6}$/.test(c)));
});
 
test("table 2 from 5 April 2026, table 3 from 4 October 2026", () => {
  assert.equal(daysBetween(EFFECTIVE[2], EFFECTIVE[3]), 182);
  assert.equal(inForce("412002", "2026-04-04"), false);
  assert.equal(inForce("412002", "2026-04-05"), true);
  assert.equal(inForce("422601", "2026-10-03"), false);
  assert.equal(inForce("422601", "2026-10-04"), true);
  assert.equal(inForce("999999", "2026-11-20"), false);
});
 
test("every duty maps to a code in the decision", () => {
  for (const code of Object.values(DUTY_TO_CODE)) assert.ok(code in OCCUPATIONS, code);
});
 
test("one non-Saudi receptionist is enough: there is no headcount threshold", () => {
  const r = reportEntity("E1", [w("a", false, "422601", { duties: ["reception"] })], "2026-11-20");
  assert.equal(r.inScope, 1);
  assert.equal(r.required, 1);
  assert.equal(r.gap, 1);
  assert.equal(r.findings[0].status, "breach-registered");
});
 
test("Saudis in localised codes create no finding", () => {
  const r = reportEntity("E1", [w("a", true, "412002", { duties: ["secretarial"] })], "2026-11-20");
  assert.equal(r.gap, 0);
  assert.deepEqual(r.findings, []);
});
 
test("a table 3 code is not a breach before 4 October", () => {
  const ws = [w("a", false, "412001", { duties: ["admin-assistance"] })];
  assert.equal(reportEntity("E1", ws, "2026-10-03").gap, 0);
  assert.equal(reportEntity("E1", ws, "2026-10-04").gap, 1);
});
 
test("localised work under another title is a breach of its own", () => {
  // "Operations officer" (code outside the list) who follows files with government agencies
  const f = assessWorker(w("a", false, "334101", { duties: ["government-relations"] }), "2026-11-20");
  assert.equal(f?.status, "breach-disguised");
  assert.deepEqual(f?.codes, ["411001"]);
  assert.equal(f?.breachSince, "2026-10-04");
});
 
test("a disguised breach starts at the earliest duty in force", () => {
  const f = assessWorker(
    w("a", false, "334101", { duties: ["reception", "data-entry", "reception"] }),
    "2026-11-20",
  );
  assert.deepEqual(f?.codes, ["413201", "422601"]);
  assert.equal(f?.breachSince, "2026-04-05");
  const before = assessWorker(w("b", false, "334101", { duties: ["reception"] }), "2026-10-03");
  assert.equal(before, undefined);
});
 
test("a localised code without the work is still counted by the system", () => {
  const f = assessWorker(w("a", false, "413201", { duties: [] }), "2026-11-20");
  assert.equal(f?.status, "code-only");
  assert.equal(f?.breachSince, "2026-04-05");
  const r = reportEntity("E1", [w("a", false, "413201")], "2026-11-20");
  assert.equal(r.gap, 1);
});
 
test("a registered breach lists every localised duty the person does", () => {
  const f = assessWorker(w("a", false, "412002", { duties: ["translation"] }), "2026-11-20");
  assert.equal(f?.status, "breach-registered");
  assert.deepEqual(f?.codes, ["264301", "412002"]);
});
 
test("a Saudi doing localised work under another code is flagged for the record", () => {
  const f = assessWorker(w("a", true, "334101", { duties: ["storekeeping"] }), "2026-11-20");
  assert.equal(f?.status, "saudi-wrong-code");
  assert.equal(f?.breachSince, undefined);
});
 
test("breach starts on the later of the effective date and the start in role", () => {
  const f = assessWorker(
    w("a", false, "541402", { duties: ["guarding"], inRoleSince: "2026-09-01" }),
    "2026-11-20",
  );
  assert.equal(f?.breachSince, "2026-09-01");
});
 
test("branches of one entity are counted together, other entities are not", () => {
  const ws = [
    w("a", true, "422601", { duties: ["reception"] }),
    w("b", false, "422601", { branchId: "B2", duties: ["reception"] }),
    w("c", false, "242311", { branchId: "B3", duties: ["recruitment"] }),
    w("x", false, "422601", { entityId: "E2", duties: ["reception"] }),
    w("y", false, "214201"),
  ];
  const r = reportEntity("E1", ws, "2026-11-20");
  assert.equal(r.inScope, 3);
  assert.equal(r.gap, 2);
  assert.deepEqual(r.byGroup, {
    "front-office": { inScope: 2, nonSaudi: 1 },
    hr: { inScope: 1, nonSaudi: 1 },
  });
  assert.equal(r.breachDays, 47 * 2);
});
 
test("action plan puts registered breaches first and counts days", () => {
  const ws = [
    w("d", true, "334101", { duties: ["data-entry"] }),
    w("c", false, "413201"),
    w("b", false, "334101", { duties: ["government-relations"] }),
    w("a", false, "412002", { duties: ["secretarial"] }),
  ];
  const lines = actionPlan(reportEntity("E1", ws, "2026-11-20"));
  assert.deepEqual(lines, [
    "Entity E1 on 2026-11-20: 0/2 Saudi in localised codes, 2 to move or replace.",
    "a: non-Saudi in Secretary (412002), 229 days since 2026-04-05. Replace, or move to other work and change the code.",
    "b: non-Saudi doing Government relations clerk (411001) under another title, 47 days since 2026-10-04. Remove these duties.",
    "c: registered as Data entry clerk (413201) but does other work, 229 days since 2026-04-05. Correct the GOSI record.",
    "d: Saudi doing Data entry clerk (413201) under another code. Register the right code.",
  ]);
});

Quatorze tests, tous verts sur Node 20 et plus, et tsc --strict sans erreur. Nous avons comparé la liste des codes à une lecture indépendante du même guide (69 codes, les mêmes 19 au tableau 2). Nous avons aussi cassé le code volontairement quatorze fois : décaler d'un jour la date du tableau 3, rendre la comparaison de dates stricte, supprimer un code, déplacer le trésorier au tableau 3, prendre la plus ancienne des deux dates, signaler les Saoudiens sous un code saoudisé, traiter chaque cas code-only comme une infraction enregistrée, ignorer la date d'effet des tâches, prendre la date de tâche la plus tardive, compter d'autres entités, ajouter un jour au décompte, relier une tâche au mauvais code, inverser l'ordre du plan et retirer la date de début des cas code-only. À chaque fois, au moins un test a échoué.

Une vérification que les tests ne peuvent pas faire : comparez votre liste à ce qu'affiche Qiwa pour la même entité. Le ministère calcule à partir de ses propres données. Quand les deux divergent, la cause est presque toujours dans les données : un code enregistré différemment à la GOSI et dans votre SIRH, ou une succursale rattachée à une autre entité.

Dépannage

Qiwa affiche une infraction et votre rapport est vide. Regardez d'abord les codes. Votre système contient peut-être un intitulé libre alors que la GOSI détient un code de la liste, et le système lit la GOSI.

Une longue liste de cas code-only. C'est courant après des années à enregistrer chacun sous le code le plus proche. Chaque cas est un dossier à corriger, pas une personne à remplacer. Ne corrigez le dossier que si la personne fait vraiment un autre travail, car l'inspecteur vérifie le travail.

Les responsables ne cochent rien. Une liste de tâches vide signifie que le cas déguisé est invisible, pas absent. Rendez le champ obligatoire et passez-le en revue une fois avec chaque responsable. C'est la seule donnée qui révèle l'infraction que le guide nomme explicitement.

Votre rapport d'octobre a bondi. Ce sont les 50 codes du tableau 3, entrés dans le champ le 4 octobre 2026. Les fonctions RH et relations publiques expliquent en général l'essentiel du saut.

Un salarié relève de deux décisions. Certains de ces codes figurent peut-être aussi dans une décision sectorielle à un taux inférieur. Le guide dit que le taux le plus élevé s'applique : à partir de sa date d'effet, c'est cette décision qui tranche.

Pour aller plus loin

Conclusion

Un taux de 100 % dès le premier salarié supprime le calcul et laisse les données. L'audit est une liste de noms, chacun avec un statut et une date de début, et l'essentiel de sa valeur tient en deux endroits que le système ne montre pas : les tâches exercées sous d'autres intitulés, et les dossiers qui disent une chose quand la personne en fait une autre.

Les deux délais de grâce sont écoulés. Le tableau 2 s'applique depuis plus de sept mois, le tableau 3 depuis plus de six semaines. Corriger les dossiers ne coûte rien et peut se faire cette semaine ; réaffecter des tâches demande une discussion avec chaque responsable ; remplacer des personnes prend des mois. Commencez par la liste.

Si vous voulez cet audit branché sur votre SIRH et exécuté avant chaque embauche, réservez une séance de diagnostic gratuite et nous examinerons vos données au regard de la décision 132249 avec vous.

Envoyez-nous votre projet

Nous répondons sous un jour ouvré.