Manuel Technique et Guide d'Utilisation - AhnizPaie

Documentation complète de l'architecture, des modules RH, des calculs de paie et du pôle Déclarations

Retour à la connexion
Architecture et Objectif du Portail

AhnizPaie est une application web full-stack développée sous Node.js et Express.js, interconnectée à une base de données relationnelle sécurisée. Elle automatise l'ensemble du cycle de paie et la liasse déclarative légale en conformité stricte avec la législation algérienne (G50, BMC-CNAS, DAS et virements bancaires).

1. Modules Fonctionnels de l'Application

1
Gestion des Salariés (CRUD)

Administration centralisée de l'effectif : Matricule unique, N° Sécurité Sociale (CNAS), fonction, situation familiale, RIB/CCP et codes SWIFT bancaires.

2
Pointage et Variables

Saisie mensuelle des éléments variables : prime véhicule, jours de panier, cotisations mutuelles spécifiques et gestion des périodes actives[cite: 8].

3
Moteur de Paie

Calcul automatisé et instantané du salaire brut, des assiettes imposables, de la retenue CNAS, de l'IRG progressif et du Net à payer.

4
Édition PDF & Historique

Génération dynamique des bulletins de paie officiels via PDFKit et archivage mensuel immuable garantissant la traçabilité des périodes clôturées.

5
Clôture Mensuelle

Fonction transactionnelle sécurisée (BEGIN/COMMIT) figeant les historiques, réinitialisant les compteurs du mois et basculant automatiquement vers la période suivante.

6
Export Bancaire Global

Génération instantanée de fichiers Excel (SheetJS) normés en 11 colonnes pour les virements de masse (Inhouse Bank, SWIFT, IBAN, Montants).

2. Le Pôle des Déclarations Légales (Fiscales & Sociales)

Identification & Organismes
  • Raison Sociale & NIF : Paramétrage centralisé de l'entreprise (EURL AHNIZTECH)[cite: 8].
  • Centre des Impôts (G50) : Rattachement direct à la recette des impôts compétente (ex: CDI Béjaïa)[cite: 8].
  • Agence CNAS : Suivi de l'agence de rattachement de sécurité sociale et de l'effectif actif déclaré[cite: 8].
Volets Déclaratifs Clés
  • Déclaration G50 (IRG) : Calcul automatisé du montant de l'IRG traitements et salaires à verser avant le 20 du mois M+1[cite: 8].
  • Bordereau CNAS (BMC) : Ventilation en temps réel de la part salariale (9%) et patronale (26%), exigible entre le 10 et le 15 du mois M+1[cite: 8].
  • Déclaration Annuelle (DAS) : Récapitulatif global de l'exercice avec génération automatique du fichier plat normé et de l'état nominatif des salariés[cite: 8].
Précisions sur la Périodicité Déclarative et la DAS (YTD)
Obligations Mensuelles Strictes :
  • G50 (IRG Salaires) : Déclaration et paiement obligatoires avant le 20 du mois suivant (M+1).
  • BMC (Bordereau Mensuel CNAS - 35%) : Déclaration et paiement obligatoires avant le 15 du mois suivant (M+1).
Role du Module DAS en cours d'année (ex: Septembre) :

La DAS officielle se dépose une seule fois par an (entre le 1er et le 31 janvier N+1). L'affichage de la DAS en cours d'année est une prévisualisation / cumul à date (YTD — Year-To-Date). Le logiciel additionne les mois clôturés pour vous offrir un suivi en temps réel et vérifier la conformité du fichier .txt sans attendre la fin d'année.

3. Formules et Règles de Calcul Algériennes

Composante de Paie Formule Mathématique & Assiette Spécificités Techniques / Barème
Cotisation CNAS Salariale Salaire de base × 9% Retenue obligatoire à la charge du salarié pour la sécurité sociale.
Cotisation CNAS Patronale Salaire de base × 26% Charge employeur intégrée dans le coût global (Total charge : 35%).
Salaire Imposable (Assiette IRG) Salaire de base - CNAS (9%) + Prime Panier + Prime Véhicule Base soumise à l'Impôt sur le Revenu Global. (Prime Panier standard : 4 400 DZD).
Calcul de l'IRG Brut & Net Barème progressif par tranches (0% à 35%) avec application d'un abattement de 40% (plafonné entre 1 000 DZD et 1 500 DZD). Ajustement spécifique intégré pour la tranche intermédiaire (30 000 à 35 000 DZD).
Salaire Net à Payer (Salaire de base + Primes) - (CNAS Salariale + IRG + Mutuelle) Montant net final viré au salarié (Mutuelle standard par défaut : 0,00 DZD).

4. Spécifications des Exports Excel (Banque)

L'application gère deux modes d'exportation sous format tableur (.xlsx) normalisé en 11 colonnes, compatibles avec les plateformes bancaires professionnelles :