API Almawarid

Factures de la société (100 au plus). Un employé sans le droit « voit toutes les factures » ne voit que les siennes.

[{"id":41,"number":"FAC-2026-0041","invoice_type":"facture","client_id":7,"status":"sent","total_ht":"10000.00","total_ttc":"11900.00"}]

Crée une facture brouillon (numéro provisoire ; le numéro définitif est tiré à l'émission). Quota de pièces du plan appliqué.

{"client_id":7,"date":"2026-10-08","payment_method":"virement","lines":[{"description":"Prestation","qty":1,"unit_price":"10000","tax_rate":19}]}

{"id":42,"number":"BRO-FAC-0007","status":"draft","total_ttc":"11900.00","lines":[…]}

Une facture avec ses lignes.

{"id":42,"number":"FAC-2026-0042","lines":[{"description":"Prestation","qty":"1.00","unit_price":"10000.00"}]}

Change le statut. Mêmes verrous que l'écran : une facture numérotée ne redevient pas brouillon, une facture encaissée ne s'annule pas (avoir), « payée » exige un reste dû nul — sinon 409.

{"status":"sent"}

{"id":42,"status":"sent"}

Versements enregistrés sur un document.

[{"id":9,"invoice_id":42,"amount":"5000.00","date":"2026-10-08","method":"virement","reference_number":"VIR-1"}]

Enregistre un versement. Un brouillon encaissé est validé automatiquement (numéro définitif) ; le statut « payée » se pose seul quand les versements couvrent le total, timbre compris. Document annulé ou proforma déjà facturée : 409.

{"amount":"5000","method":"virement","reference_number":"VIR-1"}

{"payment":{"id":9,"amount":"5000.00"},"invoice":{"id":42,"number":"FAC-2026-0042","status":"confirmed","balance_remaining":"6900.00"},"excedent":"0"}

Le document imprimable (HTML prêt à imprimer, identique au bouton « PDF » de l'écran ; « Enregistrer au format PDF » depuis le navigateur). Fonctionne pour tout type de pièce.

text/html — FAC-2026-0042.html

Devis (liste paginée).

[{"id":51,"number":"DEV-2026-0012","invoice_type":"devis","status":"draft","total_ttc":"3571.19"}]

Crée un devis. Même corps pour proformas, bons de commande, bons de livraison et avoirs.

{"client_id":7,"date":"2026-10-08","lines":[{"description":"Ciment 50 kg","qty":"2","unit_price":"1500,50","tax_rate":19}]}

{"id":51,"number":"DEV-2026-0012","total_ht":"3001.00","total_ttc":"3571.19","lines":[…]}

Un devis avec ses lignes et versements.

{"id":51,"lines":[…],"payments":[]}

Proformas (liste paginée).

[{"id":60,"number":"PRO-2026-0004"}]

Crée une proforma (corps identique aux devis).

{"client_id":7,"lines":[{"description":"Lot A","qty":1,"unit_price":"250000"}]}

{"id":60,"number":"PRO-2026-0004"}

Une proforma.

{"id":60,"lines":[…]}

Facture la proforma par la même fonction que l'écran : lignes, échéancier et versements suivent. Déjà facturée : rend sa facture (200, creee=false).

{}

{"id":61,"number":"BRO-FAC-0008","invoice_type":"facture","source_document_id":60,"creee":true}

Bons de commande client (liste paginée).

[{"id":70,"number":"BC-2026-0003"}]

Crée un bon de commande client (TVA par défaut 0, comme l'écran ; exchange_rate pour une devise étrangère).

{"client_id":7,"currency":"DZD","lines":[{"description":"Palette","qty":3,"unit_price":"9000"}]}

{"id":70,"number":"BC-2026-0003"}

Un bon de commande.

{"id":70,"lines":[…]}

Bons de livraison (liste paginée).

[{"id":80,"number":"BL-2026-0021"}]

Crée un bon de livraison (TVA par défaut 0). Le stock ne bouge pas à la création : voir stock-out.

{"client_id":7,"lines":[{"description":"Ciment 50 kg","qty":2,"unit_price":"1500"}]}

{"id":80,"number":"BL-2026-0021"}

Un bon de livraison.

{"id":80,"lines":[…]}

Sort la marchandise du stock, UNE fois (rejouée : 409). Lignes rapprochées des produits par leur nom, nomenclatures consommées, comme l'écran. 409 aussi quand Paramètres → Stock sort le stock depuis les factures, ou quand la facture de cette livraison l'a déjà sortie.

{"depot_id":2}

{"bl_id":80,"produits_sortis":1,"lignes_sans_produit":[],"depot_id":2}

Avoirs (liste paginée).

[{"id":90,"number":"AVO-2026-0002"}]

Crée un avoir brouillon (pièce fiscale : numéro définitif à l'émission). Indiquez la facture d'origine dans reference.

{"client_id":7,"reference":"Annule FAC-2026-0041","lines":[{"description":"Retour","qty":1,"unit_price":"1000"}]}

{"id":90,"number":"BRO-AVO-0001","invoice_type":"avoir"}

Un avoir.

{"id":90,"lines":[…]}

Clients de la société.

[{"id":7,"name":"SARL Atlas","city":"Oran","phone":"0550123456","nif":"000016001234567"}]

Crée un client (déclenche le webhook client.created).

{"name":"SARL Atlas","city":"Oran"}

{"id":7,"name":"SARL Atlas"}

Fiche et compte client : solde = (factures − versements) − (avoirs − remboursements), brouillons et annulées exclus, comme l'écran.

{"id":7,"name":"SARL Atlas","facture_total":"11900.00","facture_paid":"5000.00","solde":"6900.00"}

Met à jour les champs ENVOYÉS seulement. NIF, NIS, RC, AI et NIN passent par les validateurs de l'écran (400 si invalides).

{"city":"Alger","default_discount":"5"}

{"id":7,"city":"Alger","solde":"6900.00"}

Supprime un client sans document (sinon 409). Réservé au propriétaire, comme l'écran.

{"deleted":true}

Produits du catalogue avec niveau de stock en temps réel — la brique d'une intégration e-commerce.

[{"id":12,"name":"Café 250g","sku":"CAF-250","sell_price":450.0,"tax_rate":19.0,"quantity":38.0}]

Crée un produit (quota de produits du plan). opening_qty pose le stock initial au coût opening_cost (à défaut le prix d'achat) : c'est lui qui nourrit le CMUP.

{"name":"Peinture 20 L","sku":"PB-20","buy_price":"3000","sell_price":"4500","opening_qty":"12"}

{"id":13,"name":"Peinture 20 L","quantity":"12.000","cmup":"3000.0000"}

Fiche produit, stock par dépôt et 5 dernières modifications. Recette, en lecture : recette_pour (quantité que fabrique la composition), pertes_pct (perte attendue) et cout_theorique (coût unitaire par la recette, sous-recettes comprises ; null sans composition).

{"id":13,"quantity":"12.000","stock_par_depot":[{"depot_id":2,"depot":"Oran","quantity":"12.000"}],"recette_pour":"24.000","pertes_pct":"5.00","cout_theorique":"54.1530","historique":[…]}

Met à jour les champs ENVOYÉS (journalisés comme à l'écran). stock_target pose l'ajustement « Ajustement manuel → N ».

{"sell_price":"4800","stock_target":"10"}

{"id":13,"sell_price":"4800.00","quantity":"10.000"}

Mouvement de stock : delta positif = entrée, négatif = sortie. Une sortie qui rendrait le stock négatif est refusée (mêmes règles que la caisse).

{"product_id":12,"delta":10,"reason":"Réception fournisseur"}

{"movement_id":901,"quantity":33.0}

Historique des mouvements de stock, du plus récent au plus ancien.

[{"id":901,"product_id":12,"type":"in","quantity_delta":"10.000","unit_cost":"300.0000","date":"2026-10-08"}]

Dépôts de la société.

[{"id":2,"name":"Oran","is_active":true}]

Quantités par produit dans un dépôt (règle mono-dépôt de l'écran Stock comprise).

{"depot_id":2,"depot":"Oran","stock":[{"product_id":12,"name":"Café 250g","quantity":"7.000"}]}

Inventaires (sessions de comptage).

[{"id":4,"date":"2026-10-08","status":"counting","nb_lignes":120,"nb_comptees":80}]

Ouvre un inventaire : le théorique de chaque produit est FIGÉ à l'ouverture, par le calcul de l'écran.

{"label":"Fin de mois","scope":"all","blind":true}

{"id":4,"status":"draft","lines":[{"product_id":12,"expected":null,"counted":null}]}

Un inventaire et ses lignes (comptage aveugle : théorique et écart masqués jusqu'à la validation).

{"id":4,"lines":[{"product_id":12,"expected":"10.000","counted":"8.000","ecart":"-2.000"}]}

Enregistre des quantités comptées. Toutes les lignes sont validées avant écriture ; inventaire validé : 409.

{"lines":[{"product_id":12,"counted":"8","motif":"casse"}]}

{"id":4,"status":"counting","lines":[…]}

Valide l'inventaire et pose les ajustements d'écart, UNE seule fois (seconde validation : 409).

{}

{"id":4,"status":"validated","ajustements":1}

Fournisseurs (liste paginée).

[{"id":3,"name":"Lafarge","phone":"021000000","nif":""}]

Crée un fournisseur.

{"name":"Lafarge","phone":"021 00 00 00"}

{"id":3,"name":"Lafarge"}

Un fournisseur.

{"id":3,"name":"Lafarge","city":"Alger"}

Achats (bons d'achat et factures fournisseur) avec leur état de règlement.

[{"id":15,"number":"FA-77","status":"received","total_ttc":"11305.00","payment_status":"unpaid"}]

Crée un achat. status=received (facture d'achat) entre la marchandise en stock par la réception de l'écran : conversion d'unités, CMUP, produit créé si la désignation est inconnue.

{"supplier_id":3,"status":"received","number":"FA-77","lines":[{"designation":"Ciment","quantity":"10","unit_price":"800"}]}

{"id":15,"status":"received","lignes_entrees_en_stock":1,"lines":[…]}

Un achat avec ses lignes.

{"id":15,"lines":[{"designation":"Ciment","quantity":"10.000"}]}

Change le statut ; « received » entre la marchandise en stock une seule fois (rejoué : rien ne bouge).

{"status":"received"}

{"id":15,"status":"received","lignes_entrees_en_stock":1}

Salariés de la société et leur fiche RH.

[{"id":21,"hr_id":9,"email":"karim.benali@acme.dz","nom":"Benali","prenom":"Karim","poste":"Magasinier","date_embauche":"2026-09-01"}]

Crée un salarié comme l'écran « Ajouter un employé » : identifiant et mot de passe générés s'ils manquent (affichés UNE fois), aucun module accordé.

{"nom":"Benali","prenom":"Karim","poste":"Magasinier","type_contrat":"cdi","salaire_base":"45000"}

{"id":21,"identifiant":"karim.benali@acme.dz","mot_de_passe":"Xy7…","note":"Mot de passe affiché une seule fois"}

Un salarié.

{"id":21,"poste":"Magasinier","salaire_base":"45000.00"}

Met à jour la fiche RH (champs ENVOYÉS seulement ; dates invraisemblables refusées).

{"poste":"Chef magasinier","nb_enfants":2}

{"id":21,"poste":"Chef magasinier"}

Bulletins de paie (lecture seule : un bulletin s'établit à l'écran, où se vérifient barèmes, absences et avances).

[{"id":300,"employee_id":21,"mois":9,"annee":2026,"salaire_brut":"45000","irg":"…","salaire_net":"…"}]

Un bulletin avec ses rubriques (gains, retenues), cotisations et net.

{"id":300,"salaire_net":"…","lignes":[{"label":"Prime de panier","type":"gain","montant":"3000.00"}]}

Contrats et documents RH (le patron voit tout ; un employé, les siens et ceux partagés).

[{"id":5,"title":"CDI — Karim Benali","status":"finalized","language":"fr"}]

Un contrat : texte final et variables.

{"id":5,"body":"…","variables":{"salaire":"45000"}}

Pointages bruts (pointeuses et saisies manuelles), 31 jours au plus ; un chef d'équipe ne voit que ses sites.

[{"id":7001,"employee_id":21,"timestamp":"2026-10-08T07:58:00+01:00","kind":"in","manual":false}]

Avances sur salaire.

[{"id":40,"employee_id":21,"montant":"3334.00","target_mois":11,"target_annee":2026,"status":"paid"}]

Enregistre une avance ; regulariser=true la répartit sur nb_mois à partir de start_mois/start_annee, par la fonction de l'écran.

{"employee_id":21,"montant":"10000","regulariser":true,"nb_mois":3,"start_mois":11,"start_annee":2026}

[{"id":40,"montant":"3334.00","target_mois":11},{"id":41,"montant":"3333.00","target_mois":12},{"id":42,"montant":"3333.00","target_mois":1}]

Plan Entreprise : liste tous les employés actifs avec leur rôle, poste et date d'embauche.

{"count":12,"employees":[{"id":1,"email":"ahmed@acme.dz","role":"employee","nom":"Benali","prenom":"Ahmed","poste":"Comptable"}]}

Plan Entreprise : suivi du temps de toutes les équipes sur une plage de dates (max 31 jours).

{"count":45,"from":"2025-01-01","to":"2025-01-31","entries":[{"id":101,"user_email":"ahmed@acme.dz","duration_seconds":30600}]}

Plan Entreprise : demandes de congés avec filtrage par statut.

{"count":3,"leaves":[{"id":5,"employee":"sara@acme.dz","start_date":"2025-02-10","status":"approved"}]}

Plan Entreprise : informations de l'entreprise, nombre d'employés, modules actifs.

{"company":"Acme SARL","employees":12,"modules":{"erp":true,"payroll":false},"api_version":"1.0"}

Déclare une URL HTTPS à notifier (POST signé HMAC-SHA256, en-tête X-Almawarid-Signature). Événements : invoice.paid, invoice.status, client.created. Le secret n'est affiché qu'une fois.

{"url":"https://boutique.dz/hooks/almawarid","events":"invoice.paid"}

{"id":3,"url":"https://boutique.dz/hooks/almawarid","secret":"…affiché une seule fois…"}

Liste des webhooks avec leur santé (dernier statut, échecs). Un webhook qui échoue 20 fois d'affilée se désactive seul.

[{"id":3,"url":"https://boutique.dz/hooks/almawarid","is_active":true,"last_status":"http 200","failure_count":0}]

Supprime un webhook.

{"deleted":true}