Commencer gratuitement
14 jours d'essai gratuit - sans carte bancaire
Hisab
Tarifs
Ventes : +212 649 22 43 64
Commencer gratuitement

14 jours d'essai gratuit - sans carte bancaire

Connexion
Référence API v1.0

Documentation API Hisab

Intégrez la facturation électronique dans votre application avec notre API RESTful. Conformité DGI complète, webhooks et autorisation en temps réel.

Référence API
Authentification
Factures
Factures Récurrentes
Clients
Webhooks

Démarrage Rapide

L'API Hisab est organisée autour de REST. Notre API a des URLs orientées ressources prévisibles, accepte des corps de requête encodés en JSON, retourne des réponses encodées en JSON et utilise des codes de réponse HTTP standard.

URL de Base
https://hisab.ma/api/v1

Faites votre première requête

  1. Obtenez votre clé API depuis le tableau de bord
  2. Incluez-la dans l'en-tête Authorization
  3. Effectuez votre premier appel API
Limites de Taux
Les requêtes API sont limitées à 100 requêtes par minute par clé API. Passez à des plans supérieurs pour des limites accrues.

Authentification

Authentifiez vos requêtes API en utilisant des jetons Bearer. Incluez votre clé API dans l'en-tête Authorization de chaque requête.

Gardez vos clés API en sécurité
Ne jamais exposer vos clés API secrètes dans du code côté client, des dépôts publics ou du JavaScript de navigateur. Stockez-les en toute sécurité sur votre serveur.

Types de Clés API

Clé Secrète
Accès complet à tous les points de terminaison API. À utiliser uniquement sur votre serveur.
hisab_live_xxxxxxxxxxxxx
Clé Publiable
Accès en lecture seule. Sûr à utiliser dans du code côté client.
not yet developed

Codes d'Erreur

Hisab utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec d'une requête API.

400
Mauvaise Requête
La requête était invalide ou ne peut pas être servie. Vérifiez le message d'erreur pour plus de détails.
401
Non Autorisé
La clé API est manquante ou invalide.
403
Interdit
La clé API n'a pas les permissions pour effectuer cette requête.
404
Non Trouvé
La ressource demandée n'existe pas.
429
Trop de Requêtes
Vous avez dépassé la limite de taux. Veuillez ralentir.
500
Erreur Serveur Interne
Quelque chose s'est mal passé de notre côté. Veuillez réessayer plus tard.

Webhooks

Les webhooks vous permettent de recevoir des notifications en temps réel lorsque des événements se produisent dans votre compte Hisab. Enregistrez des points de terminaison webhook pour écouter des événements spécifiques.

Événements Disponibles

invoice.created

Déclenché lorsqu'une nouvelle facture est créée

invoice.finalized

Déclenché lorsqu'une facture est finalisée et autorisée par la DGI

invoice.sent

Déclenché lorsqu'une facture est envoyée au client

invoice.paid

Déclenché lorsqu'un paiement de facture est confirmé

invoice.payment_failed

Déclenché lorsqu'une tentative de paiement échoue

invoice.canceled

Déclenché lorsqu'une facture est annulée

customer.created

Déclenché lorsqu'un nouveau client est créé

customer.updated

Déclenché lorsque les informations du client sont mises à jour

SDKs Officiels

Utilisez nos bibliothèques officielles pour intégrer Hisab dans votre application plus rapidement.

Node.js / TypeScript SDK
npm install hisab-sdk

Official SDK with full TypeScript support, auto-pagination, and webhook verification.

Voir la documentation
PHP
Coming soon
composer require hisab/php
Python
Coming soon
pip install hisab
Ruby
Coming soon
gem install hisab
POST

Créer une Facture

Créer un nouveau brouillon de facture

curl -X POST https://hisab.ma/api/v1/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "d8e6b416-e946-48f8-994d-309906db0fe4",
    "issue_date": "2025-11-27",
    "due_date": "2025-12-27",
    "currency": "MAD",
    "payment_terms": "Net 30",
    "notes": "Thank you for your business",
    "items": [
      {
        "description": "Web Development Services",
        "quantity": 10,
        "unit_price": 500.00,
        "tax_rate": 20
      },
      {
        "description": "Hosting - Annual Plan",
        "quantity": 1,
        "unit_price": 1200.00,
        "tax_rate": 20
      }
    ]
  }'

Besoin d'Aide ?

Contactez notre équipe de support développeur pour obtenir de l'aide avec l'intégration API.

contact@hisab.ma →
    Documentation API - Plateforme Développeur Hisab | Hisab - E-Invoicing Morocco