Développeurs

API FACTURE

Version 1.0.0 · Brouillon pour validationMise à jour du 14 octobre 2026

Documentation de l'API partenaire FACTURE : créer les entreprises de vos clients, émettre factures, devis et avoirs, récupérer les PDF, signaler les paiements.

Adresse de basehttps://gestion-hc-2026-0003.demo.dalaone.com/api/v1

Vue d'ensemble

Quatre niveaux, dont seuls les deux premiers parlent à l'API :

FACTURE                      moteur de facturation
└── Partenaire                 votre société : détient les clés d'API
    └── Entreprise             chacun de vos clients, qui facture avec votre ERP
        │                      → /companies
        └── Client             le client de l'entreprise, qui reçoit la facture
                               → « customer » dans chaque facture ou devis
  • Vos clients ne se connectent jamais à FACTURE : ils travaillent dans votre ERP.
  • Chaque entreprise a sa propre identité sur les documents : nom, logo, RCCM, numéro d'impôt, numérotation, mentions.
  • Le catalogue et la liste de clients restent dans votre ERP : chaque document transporte ses lignes et son client.

Parcours type

1. Activer la facturation pour un de vos clients : l'ERP crée son entreprise une fois, et garde l'identifiant FACTURE reçu.

POST /companies            → { "id": "3f1c…", "external_ref": "ERP-CLIENT-0042", … }

Moment conseillé : quand vous activez le module de facturation pour ce client. Ses mentions légales et son logo sont ainsi vérifiés avant sa première facture. Créer l'entreprise à la volée, lors de la première facture, fonctionne aussi : external_ref et Idempotency-Key empêchent tout doublon. Pour des clients déjà existants, un appel par client suffit au moment de la bascule.

2. Préparer une facture dans l'ERP (brouillon), puis montrer le rendu :

POST /companies/{id}/invoices/preview      → PDF marqué APERÇU, rien d'enregistré

3. Émettre : FACTURE attribue le numéro, calcule les totaux, produit le PDF.

POST /companies/{id}/invoices              → { "number": "FAC-2026-00059", "total": "1682.00", … }
GET  /companies/{id}/invoices/{invoice_id}/pdf

L'ERP envoie lui-même le PDF ou le lien public_url à son client.

4. Signaler un paiement reçu par l'entreprise : la facture passe partially_paid puis paid.

POST /companies/{id}/invoices/{invoice_id}/payments

5. Corriger une facture émise : jamais de modification, un avoir.

POST /companies/{id}/invoices/{invoice_id}/credit-notes

Démarrage rapide

Cinq appels pour valider l'intégration, avec une clé de test (ffp_test_…), créée dans FACTURE depuis Paramètres → API. Tout ce qui est créé avec elle est marqué SPÉCIMEN et peut être supprimé.

1. Vérifier la clé

export API_KEY="ffp_test_…"
curl https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies \
  -H "Authorization: Bearer $API_KEY"

Réponse attendue : 200 et { "data": [], "next_cursor": null }.

2. Créer une entreprise de test : voir « Créer une entreprise » ; garder l'id renvoyé.

3. Prévisualiser puis émettre une facture : « Aperçu d'une facture avant émission », puis « Émettre une facture ».

4. Télécharger le PDF et enregistrer un paiement : « Télécharger le PDF d'une facture », puis « Enregistrer un paiement » ; la facture passe partially_paid ou paid.

5. Repartir de zéro quand vous le souhaitez :

curl -X DELETE https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/{company_id} \
  -H "Authorization: Bearer $API_KEY"

Une fois les tests concluants, créez une clé de production (ffp_live_…) au même endroit : les entreprises créées avec elle sont réelles, leurs documents sont conservés et ne peuvent pas être supprimés.

Le contrat complet s'importe dans Postman, Insomnia ou un générateur de code : openapi.json.

Principes

L'API permet à un partenaire d'utiliser FACTURE comme moteur de facturation pour ses propres clients, sans interface : l'ERP crée les entreprises, émet factures, devis et avoirs, récupère les PDF et signale les paiements.

  • Chaque client final du partenaire est une entreprise FACTURE, avec sa propre numérotation, ses couleurs et ses mentions.
  • FACTURE attribue les numéros et calcule les totaux : l'ERP envoie les lignes, jamais les montants calculés.
  • Un document émis n'est plus modifiable. Une correction passe par un avoir, ce qui garantit une piste d'audit complète.
  • FACTURE n'envoie rien aux clients des entreprises : l'ERP récupère le PDF ou le lien de consultation et s'en charge.
  • FACTURE n'encaisse rien : les paiements sont reçus par l'entreprise et signalés par l'ERP.
  • Les brouillons restent dans l'ERP : un document n'existe chez FACTURE qu'une fois émis. Pour montrer le rendu avant d'émettre, utiliser l'aperçu (…/invoices/preview, …/quotes/preview).

Authentification

Chaque appel porte la clé du partenaire dans l'en-tête Authorization :

Authorization: Bearer ffp_live_4tP9…
  • Un administrateur de l'entreprise abonnée crée et révoque les clés lui-même, dans Paramètres → API (5 clés actives au plus). Une clé est affichée une seule fois, à sa création ; FACTURE n'en garde qu'une empreinte.
  • Deux types : ffp_live_… pour la production, ffp_test_… pour les essais. Une clé de test ne voit que des entreprises en mode test, dont les PDF portent la mention SPÉCIMEN.
  • Une clé peut être révoquée à tout moment ; elle cesse alors de fonctionner immédiatement.
  • Une clé porte des droits (par exemple lecture seule, ou factures sans avoirs), et peut être limitée à certaines adresses IP de vos serveurs ou avoir une date d'expiration. Un appel hors de ses droits renvoie 403 forbidden avec le droit manquant.
  • Les appels se font exclusivement en HTTPS, depuis les serveurs de l'ERP. Une clé ne doit jamais figurer dans une application mobile ou une page web.

Accès selon le forfait FACTURE. Une clé rattachée à un abonné suit son forfait, vérifié à chaque appel :

ForfaitAccès
StarterPas d'API
ProVotre propre entreprise en production (elle figure dans GET /companies, avec external_ref à null), et des entreprises de test pour développer. Pas de création d'entreprises en production. Plafond : les factures du forfait (200 par mois)
BusinessComplet : votre entreprise et celles de vos clients

Si l'abonnement n'est plus actif, ou si le forfait ne comprend plus l'API, les appels renvoient 403 forbidden avec la raison.

Formats

  • Corps des requêtes et des réponses en JSON (UTF-8), sauf les PDF.
  • Montants en texte décimal, point comme séparateur, deux décimales au plus : "1250.00". Jamais de nombre à virgule flottante.
  • Quantités en texte décimal, trois décimales au plus : "2.5".
  • Dates AAAA-MM-JJ ; horodatages ISO 8601 en UTC : 2026-10-14T09:30:00Z.
  • Devises en code ISO 4217 : USD, CDF, EUR.
  • Les champs inconnus envoyés par l'ERP sont refusés (validation_error), pour éviter les fautes de frappe silencieuses.

Références externes et doublons

Entreprises, clients, factures, devis, avoirs et paiements portent un external_ref : la référence de l'ERP.

  • Elle est unique (par partenaire pour les entreprises, par entreprise pour le reste). Un deuxième document avec la même référence est refusé (409 conflict), ce qui évite les doublons en cas de nouvel essai.
  • Elle permet de retrouver un élément : GET …/invoices?external_ref=ERP-FAC-2026-1187.
  • Toute création (POST) exige en plus un en-tête Idempotency-Key : renvoyer exactement la même requête avec la même clé dans les 24 h renvoie le résultat du premier appel, sans rien créer. Réutiliser la clé avec un contenu différent est refusé (409).

Synchronisation

Pour garder l'ERP à jour, interroger périodiquement les listes avec updated_since (date du dernier passage) et suivre next_cursor jusqu'à null.

Pour cette version, les paiements vont de l'ERP vers FACTURE : FACTURE ne notifie pas l'ERP.

Le statut overdue est calculé à la lecture : une facture émise dont l'échéance est dépassée apparaît overdue, sans que sa date de modification change. Pour suivre les retards, interroger GET …/invoices?status=overdue (par exemple une fois par jour) plutôt que updated_since.

Erreurs

Les erreurs utilisent les codes HTTP usuels et un corps Error avec un code stable :

HTTPcodeQuand
400invalid_requestJSON illisible, en-tête manquant
401unauthorizedClé absente, invalide ou révoquée
403forbiddenEntreprise d'un autre partenaire, mode test/production mélangés, droit absent sur la clé, adresse IP non autorisée, fonctionnalité non activée, forfait sans API ou abonnement inactif
404not_foundÉlément introuvable
409conflictexternal_ref déjà utilisée, clé d'idempotence réutilisée autrement
409document_lockedAction impossible sur ce document (facture annulée, devis déjà transformé…)
422validation_errorChamp invalide ; le détail est dans details
422amount_exceeds_balancePaiement ou avoir supérieur au reste
429rate_limitedTrop d'appels ; réessayer après Retry-After
429limit_reachedPlafond mensuel de documents de votre contrat ou de votre forfait atteint
500server_errorErreur chez FACTURE ; réessayer avec la même Idempotency-Key
503maintenanceMaintenance en cours ; le message indique la reprise, réessayer après Retry-After

Chaque réponse porte un en-tête X-Request-Id, à communiquer au support.

Limites

  • 120 appels par minute et par clé, sauf limite propre convenue. Au-delà : 429 et un en-tête Retry-After. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset indiquent la consommation.
  • Un plafond mensuel de documents peut figurer au contrat, et les factures de votre propre entreprise suivent le plafond de votre forfait : au-delà, les créations renvoient 429 limit_reached jusqu'au mois suivant.
  • Les maintenances sont annoncées à l'avance ; pendant une maintenance, l'API répond 503 maintenance avec l'heure de reprise.
  • 500 lignes au plus par document.
  • Chaque appel est journalisé (clé, entreprise, opération, résultat, horodatage) et conservé pour l'audit.

Versions

L'adresse porte la version : /api/v1. Dans une version, FACTURE peut ajouter des champs ou des opérations, jamais en retirer ou en changer le sens : l'ERP doit ignorer les champs qu'il ne connaît pas dans les réponses. Un changement incompatible donnerait une /api/v2, annoncée à l'avance.

Entreprises

Les entreprises des clients finaux du partenaire.

Créer une entreprise

post/companies

Crée l'entreprise d'un client final. Elle est immédiatement utilisable : aucun abonnement, la facturation passe par le contrat partenaire. Avec une clé de test, l'entreprise est créée en mode test.

Paramètres

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · CompanyInput

external_reftexteobligatoire

Référence de l'entreprise dans l'ERP. Unique par partenaire.

nametexteobligatoire

Raison sociale, telle qu'elle figure sur les documents.

emailtextepeut être nul

E-mail de contact imprimé sur les documents.

phonetextepeut être nul

Téléphone imprimé sur les documents.

addresstextepeut être nul

Adresse du siège.

rccmtextepeut être nul

Registre du commerce et du crédit mobilier.

id_nattextepeut être nul

Identification nationale.

tax_numbertextepeut être nul

Numéro d'impôt.

currencytexteobligatoire

Devise par défaut (ISO 4217).

vat_ratetexte

Taux de TVA par défaut, en pourcentage.

brandingobjet

Apparence des PDF. Le logo est copié chez FACTURE à l'enregistrement.

logo_urltextepeut être nul

Adresse HTTPS d'une image PNG ou JPEG (5 Mo au plus).

brand_colortexte

Couleur de marque.

header_colortexte

Couleur d'en-tête.

invoice_templatetexte

Modèle de mise en page des factures et devis.

classiccleancompactsidebarcenteredletterheaddetailedreceiptthermalbilingualbold
numberingobjet

Numérotation des documents. Les numéros sont attribués par FACTURE, sans trou.

invoice_prefixtexte

Préfixe des factures.

quote_prefixtexte

Préfixe des devis.

credit_prefixtexte

Préfixe des avoirs.

include_yearbooléen

Ajoute l'année (FAC-2026-00059) ; le compteur repart à 1 chaque 1er janvier.

document_textsobjet

Textes imprimés en bas des documents.

payment_termstextepeut être nul

Conditions de paiement.

bank_detailstextepeut être nul

Coordonnées bancaires.

legal_mentionstextepeut être nul

Mentions légales.

Réponse · 201

Entreprise créée.

Erreurs possibles : 400401409422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-CLIENT-0042",
    "name": "Kivu Services SARL",
    "email": "facturation@kivu-services.cd",
    "phone": "+243 810 000 000",
    "address": "45 avenue de la Paix, Goma",
    "rccm": "CD/GOM/RCCM/22-B-0123",
    "id_nat": "01-234-N56789",
    "tax_number": "A1234567B",
    "currency": "USD",
    "vat_rate": "16",
    "branding": {
      "logo_url": "https://erp.exemple.com/logos/kivu.png",
      "brand_color": "#0F766E",
      "header_color": "#0F172A",
      "invoice_template": "classic"
    },
    "numbering": {
      "invoice_prefix": "FAC-",
      "quote_prefix": "DEV-",
      "credit_prefix": "AV-",
      "include_year": true
    },
    "document_texts": {
      "payment_terms": "Paiement à 30 jours.",
      "bank_details": "Rawbank · CD00 0000 0000 0000",
      "legal_mentions": null
    }
  }'
Réponse 201
{
  "id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "mode": "live",
  "external_ref": "ERP-CLIENT-0042",
  "name": "Kivu Services SARL",
  "email": "facturation@kivu-services.cd",
  "phone": "+243 810 000 000",
  "address": "45 avenue de la Paix, Goma",
  "rccm": "CD/GOM/RCCM/22-B-0123",
  "id_nat": "01-234-N56789",
  "tax_number": "A1234567B",
  "currency": "USD",
  "vat_rate": "16",
  "branding": {
    "logo_url": "https://erp.exemple.com/logos/kivu.png",
    "brand_color": "#0F766E",
    "header_color": "#0F172A",
    "invoice_template": "classic"
  },
  "numbering": {
    "invoice_prefix": "FAC-",
    "quote_prefix": "DEV-",
    "credit_prefix": "AV-",
    "include_year": true
  },
  "document_texts": {
    "payment_terms": "Paiement à 30 jours.",
    "bank_details": "Rawbank · CD00 0000 0000 0000",
    "legal_mentions": null
  },
  "created_at": "2026-10-14T09:12:00Z",
  "updated_at": "2026-10-14T09:12:00Z"
}

Lister les entreprises

get/companies

Les entreprises créées par le partenaire.

Paramètres

external_refrequête · texte

Retrouve l'élément par la référence de l'ERP.

updated_sincerequête · date-heure

Ne renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.

limitrequête · entier

Nombre d'éléments par page (1 à 100).

cursorrequête · texte

Curseur renvoyé par la page précédente (`next_cursor`).

Réponse · 200

Une page d'entreprises (data : liste de Company).

Erreurs possibles : 401429503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "data": [
    {
      "id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "mode": "live",
      "external_ref": "ERP-CLIENT-0042",
      "name": "Kivu Services SARL",
      "email": "facturation@kivu-services.cd",
      "phone": "+243 810 000 000",
      "address": "45 avenue de la Paix, Goma",
      "rccm": "CD/GOM/RCCM/22-B-0123",
      "id_nat": "01-234-N56789",
      "tax_number": "A1234567B",
      "currency": "USD",
      "vat_rate": "16",
      "branding": {
        "logo_url": "https://erp.exemple.com/logos/kivu.png",
        "brand_color": "#0F766E",
        "header_color": "#0F172A",
        "invoice_template": "classic"
      },
      "numbering": {
        "invoice_prefix": "FAC-",
        "quote_prefix": "DEV-",
        "credit_prefix": "AV-",
        "include_year": true
      },
      "document_texts": {
        "payment_terms": "Paiement à 30 jours.",
        "bank_details": "Rawbank · CD00 0000 0000 0000",
        "legal_mentions": null
      },
      "created_at": "2026-10-14T09:12:00Z",
      "updated_at": "2026-10-14T09:12:00Z"
    }
  ],
  "next_cursor": null
}

Lire une entreprise

get/companies/{company_id}

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Réponse · 200

L'entreprise.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "mode": "live",
  "external_ref": "ERP-CLIENT-0042",
  "name": "Kivu Services SARL",
  "email": "facturation@kivu-services.cd",
  "phone": "+243 810 000 000",
  "address": "45 avenue de la Paix, Goma",
  "rccm": "CD/GOM/RCCM/22-B-0123",
  "id_nat": "01-234-N56789",
  "tax_number": "A1234567B",
  "currency": "USD",
  "vat_rate": "16",
  "branding": {
    "logo_url": "https://erp.exemple.com/logos/kivu.png",
    "brand_color": "#0F766E",
    "header_color": "#0F172A",
    "invoice_template": "classic"
  },
  "numbering": {
    "invoice_prefix": "FAC-",
    "quote_prefix": "DEV-",
    "credit_prefix": "AV-",
    "include_year": true
  },
  "document_texts": {
    "payment_terms": "Paiement à 30 jours.",
    "bank_details": "Rawbank · CD00 0000 0000 0000",
    "legal_mentions": null
  },
  "created_at": "2026-10-14T09:12:00Z",
  "updated_at": "2026-10-14T09:12:00Z"
}

Supprimer une entreprise de test

delete/companies/{company_id}

Efface une entreprise en mode test et tout son contenu (clients, factures, devis, avoirs, paiements), pour repartir d'une base propre pendant le développement. Une entreprise de production ne peut pas être supprimée (403 forbidden) : ses documents doivent être conservés.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Réponse · 204

Entreprise supprimée (réponse sans corps).

Erreurs possibles : 401403404503

Requête
curl -X DELETE "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…" \
  -H "Authorization: Bearer $API_KEY"

Modifier une entreprise

patch/companies/{company_id}

Seuls les champs envoyés sont modifiés. Les documents déjà émis ne changent pas ; les suivants reprennent les nouvelles informations.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Corps de la requête · CompanyUpdate

external_reftexte

Référence de l'entreprise dans l'ERP. Unique par partenaire.

nametexte

Raison sociale, telle qu'elle figure sur les documents.

emailtextepeut être nul

E-mail de contact imprimé sur les documents.

phonetextepeut être nul

Téléphone imprimé sur les documents.

addresstextepeut être nul

Adresse du siège.

rccmtextepeut être nul

Registre du commerce et du crédit mobilier.

id_nattextepeut être nul

Identification nationale.

tax_numbertextepeut être nul

Numéro d'impôt.

currencytexte

Devise par défaut (ISO 4217).

vat_ratetexte

Taux de TVA par défaut, en pourcentage.

brandingobjet

Apparence des PDF. Le logo est copié chez FACTURE à l'enregistrement.

logo_urltextepeut être nul

Adresse HTTPS d'une image PNG ou JPEG (5 Mo au plus).

brand_colortexte

Couleur de marque.

header_colortexte

Couleur d'en-tête.

invoice_templatetexte

Modèle de mise en page des factures et devis.

classiccleancompactsidebarcenteredletterheaddetailedreceiptthermalbilingualbold
numberingobjet

Numérotation des documents. Les numéros sont attribués par FACTURE, sans trou.

invoice_prefixtexte

Préfixe des factures.

quote_prefixtexte

Préfixe des devis.

credit_prefixtexte

Préfixe des avoirs.

include_yearbooléen

Ajoute l'année (FAC-2026-00059) ; le compteur repart à 1 chaque 1er janvier.

document_textsobjet

Textes imprimés en bas des documents.

payment_termstextepeut être nul

Conditions de paiement.

bank_detailstextepeut être nul

Coordonnées bancaires.

legal_mentionstextepeut être nul

Mentions légales.

Réponse · 200

L'entreprise modifiée.

Erreurs possibles : 400401403404422503

Requête
curl -X PATCH "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+243 820 000 000",
    "branding": {
      "invoice_template": "detailed"
    }
  }'
Réponse 200
{
  "id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "mode": "live",
  "external_ref": "ERP-CLIENT-0042",
  "name": "Kivu Services SARL",
  "email": "facturation@kivu-services.cd",
  "phone": "+243 810 000 000",
  "address": "45 avenue de la Paix, Goma",
  "rccm": "CD/GOM/RCCM/22-B-0123",
  "id_nat": "01-234-N56789",
  "tax_number": "A1234567B",
  "currency": "USD",
  "vat_rate": "16",
  "branding": {
    "logo_url": "https://erp.exemple.com/logos/kivu.png",
    "brand_color": "#0F766E",
    "header_color": "#0F172A",
    "invoice_template": "classic"
  },
  "numbering": {
    "invoice_prefix": "FAC-",
    "quote_prefix": "DEV-",
    "credit_prefix": "AV-",
    "include_year": true
  },
  "document_texts": {
    "payment_terms": "Paiement à 30 jours.",
    "bank_details": "Rawbank · CD00 0000 0000 0000",
    "legal_mentions": null
  },
  "created_at": "2026-10-14T09:12:00Z",
  "updated_at": "2026-10-14T09:12:00Z"
}

Factures

Émission et lecture des factures.

Émettre une facture

post/companies/{company_id}/invoices

Crée et émet la facture : FACTURE attribue le numéro, calcule les totaux et produit le PDF. Une facture émise n'est plus modifiable ; toute correction passe par un avoir.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · InvoiceInput

external_reftexteobligatoire

Référence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).

customerCustomerInputobligatoire

Client destinataire du document. Créé ou mis à jour à chaque document, retrouvé par external_ref : l'ERP n'a pas à gérer les clients séparément.

external_reftexteobligatoire

Référence du client dans l'ERP. Unique par entreprise.

nametexteobligatoire

Nom du contact ou de la personne.

companytextepeut être nul

Raison sociale (imprimée en premier si présente).

emailtextepeut être nul
phonetextepeut être nul
addresstextepeut être nul
tax_idtextepeut être nul

Numéro fiscal du client.

issue_datedateobligatoire

Date d'émission (AAAA-MM-JJ).

currencytexte

Devise ; par défaut celle de l'entreprise.

vat_ratetexte

Taux de TVA en pourcentage ; par défaut celui de l'entreprise.

discountmontant

Remise globale, hors taxes.

shipping_amountmontant

Frais d'expédition, hors taxes.

adjustment_amountmontant

Ajustement hors taxes, positif ou négatif.

order_numbertextepeut être nul

Numéro de commande du client.

notestextepeut être nul

Note imprimée sur le document.

linesLineInput[]obligatoire
descriptiontexteobligatoire

Désignation.

quantitytexteobligatoire

Quantité, supérieure à 0 (trois décimales au plus).

unit_pricemontantobligatoire

Prix unitaire hors taxes.

due_datedatepeut être nul

Date d'échéance.

Réponse · 201

Facture émise.

Erreurs possibles : 400401403404409422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-FAC-2026-1187",
    "customer": {
      "external_ref": "ERP-TIERS-778",
      "name": "Aline Mbuyi",
      "company": "Studio Kivu",
      "email": "compta@studio-kivu.cd",
      "phone": "+243 811 111 111",
      "address": "12 avenue du Lac, Goma",
      "tax_id": "A7654321C"
    },
    "issue_date": "2026-10-14",
    "due_date": "2026-11-13",
    "currency": "USD",
    "vat_rate": "16",
    "discount": "50.00",
    "order_number": "BC-2026-031",
    "notes": "Merci de rappeler le numéro de facture lors du paiement.",
    "lines": [
      {
        "description": "Audit des comptes annuels 2025",
        "quantity": "1",
        "unit_price": "1200.00"
      },
      {
        "description": "Rapport de recommandations",
        "quantity": "2",
        "unit_price": "150.00"
      }
    ]
  }'
Réponse 201
{
  "id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-FAC-2026-1187",
  "number": "FAC-2026-00059",
  "status": "issued",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "due_date": "2026-11-13",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "amount_paid": "0.00",
  "amount_credited": "0.00",
  "balance_due": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/invoice/kQ3v…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/invoices/8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z"
}

Lister les factures

get/companies/{company_id}/invoices

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

statusrequête · texte

Filtre par statut.

external_refrequête · texte

Retrouve l'élément par la référence de l'ERP.

updated_sincerequête · date-heure

Ne renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.

limitrequête · entier

Nombre d'éléments par page (1 à 100).

cursorrequête · texte

Curseur renvoyé par la page précédente (`next_cursor`).

Réponse · 200

Une page de factures (data : liste d'Invoice).

Erreurs possibles : 401403404429503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "data": [
    {
      "id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
      "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "external_ref": "ERP-FAC-2026-1187",
      "number": "FAC-2026-00059",
      "status": "issued",
      "customer": {
        "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
        "external_ref": "ERP-TIERS-778",
        "name": "Aline Mbuyi",
        "company": "Studio Kivu",
        "email": "compta@studio-kivu.cd",
        "phone": "+243 811 111 111",
        "address": "12 avenue du Lac, Goma",
        "tax_id": "A7654321C"
      },
      "issue_date": "2026-10-14",
      "due_date": "2026-11-13",
      "currency": "USD",
      "order_number": "BC-2026-031",
      "notes": "Merci de rappeler le numéro de facture lors du paiement.",
      "lines": [
        {
          "description": "Audit des comptes annuels 2025",
          "quantity": "1",
          "unit_price": "1200.00",
          "total": "1200.00"
        },
        {
          "description": "Rapport de recommandations",
          "quantity": "2",
          "unit_price": "150.00",
          "total": "300.00"
        }
      ],
      "subtotal": "1500.00",
      "discount": "50.00",
      "shipping_amount": "0.00",
      "adjustment_amount": "0.00",
      "taxable_base": "1450.00",
      "vat_rate": "16",
      "vat_amount": "232.00",
      "total": "1682.00",
      "amount_paid": "0.00",
      "amount_credited": "0.00",
      "balance_due": "1682.00",
      "first_viewed_at": "2026-10-14T10:32:00Z",
      "last_viewed_at": "2026-10-16T08:05:00Z",
      "view_count": 2,
      "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/invoice/kQ3v…",
      "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/invoices/8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d/pdf",
      "created_at": "2026-10-14T09:30:00Z",
      "updated_at": "2026-10-14T09:30:00Z"
    }
  ],
  "next_cursor": "eyJjIjoiMjAyNi0xMC0xNFQwOTozMDowMFoifQ"
}

Aperçu d'une facture avant émission

post/companies/{company_id}/invoices/preview

Produit le PDF du document tel qu'il serait émis, marqué APERÇU, avec un numéro provisoire. Rien n'est enregistré, aucun numéro n'est consommé : l'utilisateur vérifie le rendu dans l'ERP avant de cliquer « Émettre ».

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Corps de la requête · InvoicePreviewInput

external_reftexte

Référence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).

customerCustomerInputobligatoire

Client destinataire du document. Créé ou mis à jour à chaque document, retrouvé par external_ref : l'ERP n'a pas à gérer les clients séparément.

external_reftexteobligatoire

Référence du client dans l'ERP. Unique par entreprise.

nametexteobligatoire

Nom du contact ou de la personne.

companytextepeut être nul

Raison sociale (imprimée en premier si présente).

emailtextepeut être nul
phonetextepeut être nul
addresstextepeut être nul
tax_idtextepeut être nul

Numéro fiscal du client.

issue_datedateobligatoire

Date d'émission (AAAA-MM-JJ).

currencytexte

Devise ; par défaut celle de l'entreprise.

vat_ratetexte

Taux de TVA en pourcentage ; par défaut celui de l'entreprise.

discountmontant

Remise globale, hors taxes.

shipping_amountmontant

Frais d'expédition, hors taxes.

adjustment_amountmontant

Ajustement hors taxes, positif ou négatif.

order_numbertextepeut être nul

Numéro de commande du client.

notestextepeut être nul

Note imprimée sur le document.

linesLineInput[]obligatoire
descriptiontexteobligatoire

Désignation.

quantitytexteobligatoire

Quantité, supérieure à 0 (trois décimales au plus).

unit_pricemontantobligatoire

Prix unitaire hors taxes.

due_datedatepeut être nul

Date d'échéance.

Réponse · 200

Le PDF d'aperçu.

Erreurs possibles : 400401403404422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/preview" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "external_ref": "ERP-TIERS-778",
      "name": "Aline Mbuyi",
      "company": "Studio Kivu",
      "email": "compta@studio-kivu.cd",
      "phone": "+243 811 111 111",
      "address": "12 avenue du Lac, Goma",
      "tax_id": "A7654321C"
    },
    "issue_date": "2026-10-14",
    "due_date": "2026-11-13",
    "currency": "USD",
    "vat_rate": "16",
    "discount": "50.00",
    "order_number": "BC-2026-031",
    "notes": "Merci de rappeler le numéro de facture lors du paiement.",
    "lines": [
      {
        "description": "Audit des comptes annuels 2025",
        "quantity": "1",
        "unit_price": "1200.00"
      },
      {
        "description": "Rapport de recommandations",
        "quantity": "2",
        "unit_price": "150.00"
      }
    ]
  }' \
  -o document.pdf

Lire une facture

get/companies/{company_id}/invoices/{invoice_id}

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

invoice_idchemin · uuidobligatoire

Identifiant de la facture.

Réponse · 200

La facture.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-FAC-2026-1187",
  "number": "FAC-2026-00059",
  "status": "issued",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "due_date": "2026-11-13",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "amount_paid": "0.00",
  "amount_credited": "0.00",
  "balance_due": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/invoice/kQ3v…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/invoices/8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z"
}

Télécharger le PDF d'une facture

get/companies/{company_id}/invoices/{invoice_id}/pdf

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

invoice_idchemin · uuidobligatoire

Identifiant de la facture.

Réponse · 200

Le document PDF, au modèle de l'entreprise.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>/pdf" \
  -H "Authorization: Bearer $API_KEY" \
  -o document.pdf

Paiements

Règlements signalés par l'ERP.

Enregistrer un paiement

post/companies/{company_id}/invoices/{invoice_id}/payments

Signale à FACTURE un règlement reçu dans l'ERP. Le statut de la facture suit : partially_paid, puis paid quand le reste à payer atteint 0. Un montant supérieur au reste à payer est refusé (amount_exceeds_balance).

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

invoice_idchemin · uuidobligatoire

Identifiant de la facture.

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · PaymentInput

external_reftexteobligatoire

Référence du règlement dans l'ERP. Unique par entreprise.

amountmontantobligatoire

Montant réglé, au plus égal au reste à payer.

paid_atdate-heureobligatoire

Date et heure du règlement.

methodtexteobligatoire

Moyen de paiement.

cashbank_transfercardmobile_moneychequeother
referencetextepeut être nul

Référence bancaire ou de transaction.

Réponse · 201

Paiement enregistré.

Erreurs possibles : 400401403404409422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>/payments" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-REG-5521",
    "amount": "1000.00",
    "paid_at": "2026-10-20T14:05:00Z",
    "method": "bank_transfer",
    "reference": "VIR-RAW-778812"
  }'
Réponse 201
{
  "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
  "invoice_id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "external_ref": "ERP-REG-5521",
  "amount": "1000.00",
  "paid_at": "2026-10-20T14:05:00Z",
  "method": "bank_transfer",
  "reference": "VIR-RAW-778812",
  "created_at": "2026-10-20T14:06:10Z"
}

Lister les paiements d'une facture

get/companies/{company_id}/invoices/{invoice_id}/payments

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

invoice_idchemin · uuidobligatoire

Identifiant de la facture.

Réponse · 200

Les paiements (data : liste de Payment).

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>/payments" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "data": [
    {
      "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "invoice_id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
      "external_ref": "ERP-REG-5521",
      "amount": "1000.00",
      "paid_at": "2026-10-20T14:05:00Z",
      "method": "bank_transfer",
      "reference": "VIR-RAW-778812",
      "created_at": "2026-10-20T14:06:10Z"
    }
  ],
  "next_cursor": null
}

Avoirs

Corrections des factures émises.

Émettre un avoir

post/companies/{company_id}/invoices/{invoice_id}/credit-notes

Seule façon de corriger une facture émise. Sans lignes : avoir total, la facture passe cancelled. Avec lignes : avoir partiel, déduit du reste à payer. Le total des avoirs ne peut pas dépasser le total de la facture.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

invoice_idchemin · uuidobligatoire

Identifiant de la facture.

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · CreditNoteInput

external_reftexteobligatoire

Référence de l'avoir dans l'ERP. Unique par entreprise.

issue_datedateobligatoire
reasontexteobligatoire

Motif, imprimé sur l'avoir.

linesLineInput[]

Lignes de l'avoir. Absentes : avoir total, qui reprend toute la facture et l'annule (cancelled).

descriptiontexteobligatoire

Désignation.

quantitytexteobligatoire

Quantité, supérieure à 0 (trois décimales au plus).

unit_pricemontantobligatoire

Prix unitaire hors taxes.

Réponse · 201

Avoir émis.

Erreurs possibles : 400401403404409422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>/credit-notes" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-AV-2026-0007",
    "issue_date": "2026-10-22",
    "reason": "Remise commerciale accordée après réclamation",
    "lines": [
      {
        "description": "Geste commercial",
        "quantity": "1",
        "unit_price": "100.00"
      }
    ]
  }'
Réponse 201
{
  "id": "9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a",
  "invoice_id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "number": "AV-2026-00003",
  "external_ref": "ERP-AV-2026-0007",
  "issue_date": "2026-10-22",
  "reason": "Remise commerciale accordée après réclamation",
  "lines": [
    {
      "description": "Geste commercial",
      "quantity": "1",
      "unit_price": "100.00",
      "total": "100.00"
    }
  ],
  "subtotal": "100.00",
  "vat_rate": "16",
  "vat_amount": "16.00",
  "total": "116.00",
  "currency": "USD",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/credit-notes/9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a/pdf",
  "created_at": "2026-10-22T10:00:00Z"
}

Lire un avoir

get/companies/{company_id}/credit-notes/{credit_note_id}

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

credit_note_idchemin · uuidobligatoire

Identifiant de l'avoir.

Réponse · 200

L'avoir.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/credit-notes/<credit_note_id>" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a",
  "invoice_id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "number": "AV-2026-00003",
  "external_ref": "ERP-AV-2026-0007",
  "issue_date": "2026-10-22",
  "reason": "Remise commerciale accordée après réclamation",
  "lines": [
    {
      "description": "Geste commercial",
      "quantity": "1",
      "unit_price": "100.00",
      "total": "100.00"
    }
  ],
  "subtotal": "100.00",
  "vat_rate": "16",
  "vat_amount": "16.00",
  "total": "116.00",
  "currency": "USD",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/credit-notes/9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a/pdf",
  "created_at": "2026-10-22T10:00:00Z"
}

Télécharger le PDF d'un avoir

get/companies/{company_id}/credit-notes/{credit_note_id}/pdf

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

credit_note_idchemin · uuidobligatoire

Identifiant de l'avoir.

Réponse · 200

Le document PDF, au modèle de l'entreprise.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/credit-notes/<credit_note_id>/pdf" \
  -H "Authorization: Bearer $API_KEY" \
  -o document.pdf

Devis

Émission, suivi et transformation en facture.

Émettre un devis

post/companies/{company_id}/quotes

Crée et émet le devis : numéro attribué par FACTURE, totaux calculés, PDF disponible.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · QuoteInput

external_reftexteobligatoire

Référence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).

customerCustomerInputobligatoire

Client destinataire du document. Créé ou mis à jour à chaque document, retrouvé par external_ref : l'ERP n'a pas à gérer les clients séparément.

external_reftexteobligatoire

Référence du client dans l'ERP. Unique par entreprise.

nametexteobligatoire

Nom du contact ou de la personne.

companytextepeut être nul

Raison sociale (imprimée en premier si présente).

emailtextepeut être nul
phonetextepeut être nul
addresstextepeut être nul
tax_idtextepeut être nul

Numéro fiscal du client.

issue_datedateobligatoire

Date d'émission (AAAA-MM-JJ).

currencytexte

Devise ; par défaut celle de l'entreprise.

vat_ratetexte

Taux de TVA en pourcentage ; par défaut celui de l'entreprise.

discountmontant

Remise globale, hors taxes.

shipping_amountmontant

Frais d'expédition, hors taxes.

adjustment_amountmontant

Ajustement hors taxes, positif ou négatif.

order_numbertextepeut être nul

Numéro de commande du client.

notestextepeut être nul

Note imprimée sur le document.

linesLineInput[]obligatoire
descriptiontexteobligatoire

Désignation.

quantitytexteobligatoire

Quantité, supérieure à 0 (trois décimales au plus).

unit_pricemontantobligatoire

Prix unitaire hors taxes.

valid_untildatepeut être nul

Date de fin de validité de l'offre.

Réponse · 201

Devis émis.

Erreurs possibles : 400401403404409422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-DEV-2026-0311",
    "customer": {
      "external_ref": "ERP-TIERS-778",
      "name": "Aline Mbuyi",
      "company": "Studio Kivu",
      "email": "compta@studio-kivu.cd",
      "phone": "+243 811 111 111",
      "address": "12 avenue du Lac, Goma",
      "tax_id": "A7654321C"
    },
    "issue_date": "2026-10-14",
    "currency": "USD",
    "vat_rate": "16",
    "discount": "50.00",
    "order_number": "BC-2026-031",
    "notes": "Merci de rappeler le numéro de facture lors du paiement.",
    "lines": [
      {
        "description": "Audit des comptes annuels 2025",
        "quantity": "1",
        "unit_price": "1200.00"
      },
      {
        "description": "Rapport de recommandations",
        "quantity": "2",
        "unit_price": "150.00"
      }
    ],
    "valid_until": "2026-11-14"
  }'
Réponse 201
{
  "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-DEV-2026-0311",
  "number": "DEV-2026-00008",
  "status": "issued",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/quote/Zp8w…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/quotes/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z",
  "valid_until": "2026-11-14",
  "invoice_id": null
}

Lister les devis

get/companies/{company_id}/quotes

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

statusrequête · texte

Filtre par statut.

external_refrequête · texte

Retrouve l'élément par la référence de l'ERP.

updated_sincerequête · date-heure

Ne renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.

limitrequête · entier

Nombre d'éléments par page (1 à 100).

cursorrequête · texte

Curseur renvoyé par la page précédente (`next_cursor`).

Réponse · 200

Une page de devis (data : liste de Quote).

Erreurs possibles : 401403404429503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "data": [
    {
      "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
      "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "external_ref": "ERP-DEV-2026-0311",
      "number": "DEV-2026-00008",
      "status": "issued",
      "customer": {
        "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
        "external_ref": "ERP-TIERS-778",
        "name": "Aline Mbuyi",
        "company": "Studio Kivu",
        "email": "compta@studio-kivu.cd",
        "phone": "+243 811 111 111",
        "address": "12 avenue du Lac, Goma",
        "tax_id": "A7654321C"
      },
      "issue_date": "2026-10-14",
      "currency": "USD",
      "order_number": "BC-2026-031",
      "notes": "Merci de rappeler le numéro de facture lors du paiement.",
      "lines": [
        {
          "description": "Audit des comptes annuels 2025",
          "quantity": "1",
          "unit_price": "1200.00",
          "total": "1200.00"
        },
        {
          "description": "Rapport de recommandations",
          "quantity": "2",
          "unit_price": "150.00",
          "total": "300.00"
        }
      ],
      "subtotal": "1500.00",
      "discount": "50.00",
      "shipping_amount": "0.00",
      "adjustment_amount": "0.00",
      "taxable_base": "1450.00",
      "vat_rate": "16",
      "vat_amount": "232.00",
      "total": "1682.00",
      "first_viewed_at": "2026-10-14T10:32:00Z",
      "last_viewed_at": "2026-10-16T08:05:00Z",
      "view_count": 2,
      "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/quote/Zp8w…",
      "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/quotes/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716/pdf",
      "created_at": "2026-10-14T09:30:00Z",
      "updated_at": "2026-10-14T09:30:00Z",
      "valid_until": "2026-11-14",
      "invoice_id": null
    }
  ],
  "next_cursor": null
}

Aperçu d'un devis avant émission

post/companies/{company_id}/quotes/preview

Produit le PDF du document tel qu'il serait émis, marqué APERÇU, avec un numéro provisoire. Rien n'est enregistré, aucun numéro n'est consommé : l'utilisateur vérifie le rendu dans l'ERP avant de cliquer « Émettre ».

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

Corps de la requête · QuotePreviewInput

external_reftexte

Référence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).

customerCustomerInputobligatoire

Client destinataire du document. Créé ou mis à jour à chaque document, retrouvé par external_ref : l'ERP n'a pas à gérer les clients séparément.

external_reftexteobligatoire

Référence du client dans l'ERP. Unique par entreprise.

nametexteobligatoire

Nom du contact ou de la personne.

companytextepeut être nul

Raison sociale (imprimée en premier si présente).

emailtextepeut être nul
phonetextepeut être nul
addresstextepeut être nul
tax_idtextepeut être nul

Numéro fiscal du client.

issue_datedateobligatoire

Date d'émission (AAAA-MM-JJ).

currencytexte

Devise ; par défaut celle de l'entreprise.

vat_ratetexte

Taux de TVA en pourcentage ; par défaut celui de l'entreprise.

discountmontant

Remise globale, hors taxes.

shipping_amountmontant

Frais d'expédition, hors taxes.

adjustment_amountmontant

Ajustement hors taxes, positif ou négatif.

order_numbertextepeut être nul

Numéro de commande du client.

notestextepeut être nul

Note imprimée sur le document.

linesLineInput[]obligatoire
descriptiontexteobligatoire

Désignation.

quantitytexteobligatoire

Quantité, supérieure à 0 (trois décimales au plus).

unit_pricemontantobligatoire

Prix unitaire hors taxes.

valid_untildatepeut être nul

Date de fin de validité de l'offre.

Réponse · 200

Le PDF d'aperçu.

Erreurs possibles : 400401403404422429503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/preview" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "external_ref": "ERP-TIERS-778",
      "name": "Aline Mbuyi",
      "company": "Studio Kivu",
      "email": "compta@studio-kivu.cd",
      "phone": "+243 811 111 111",
      "address": "12 avenue du Lac, Goma",
      "tax_id": "A7654321C"
    },
    "issue_date": "2026-10-14",
    "currency": "USD",
    "vat_rate": "16",
    "discount": "50.00",
    "order_number": "BC-2026-031",
    "notes": "Merci de rappeler le numéro de facture lors du paiement.",
    "lines": [
      {
        "description": "Audit des comptes annuels 2025",
        "quantity": "1",
        "unit_price": "1200.00"
      },
      {
        "description": "Rapport de recommandations",
        "quantity": "2",
        "unit_price": "150.00"
      }
    ],
    "valid_until": "2026-11-14"
  }' \
  -o document.pdf

Lire un devis

get/companies/{company_id}/quotes/{quote_id}

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

quote_idchemin · uuidobligatoire

Identifiant du devis.

Réponse · 200

Le devis.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-DEV-2026-0311",
  "number": "DEV-2026-00008",
  "status": "issued",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/quote/Zp8w…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/quotes/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z",
  "valid_until": "2026-11-14",
  "invoice_id": null
}

Télécharger le PDF d'un devis

get/companies/{company_id}/quotes/{quote_id}/pdf

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

quote_idchemin · uuidobligatoire

Identifiant du devis.

Réponse · 200

Le document PDF, au modèle de l'entreprise.

Erreurs possibles : 401403404503

Requête
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/pdf" \
  -H "Authorization: Bearer $API_KEY" \
  -o document.pdf

Marquer un devis accepté

post/companies/{company_id}/quotes/{quote_id}/accept

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

quote_idchemin · uuidobligatoire

Identifiant du devis.

Réponse · 200

Le devis, accepted.

Erreurs possibles : 401403404409503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/accept" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-DEV-2026-0311",
  "number": "DEV-2026-00008",
  "status": "accepted",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/quote/Zp8w…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/quotes/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z",
  "valid_until": "2026-11-14",
  "invoice_id": null
}

Marquer un devis refusé

post/companies/{company_id}/quotes/{quote_id}/refuse

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

quote_idchemin · uuidobligatoire

Identifiant du devis.

Réponse · 200

Le devis, refused.

Erreurs possibles : 401403404409503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/refuse" \
  -H "Authorization: Bearer $API_KEY"
Réponse 200
{
  "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-DEV-2026-0311",
  "number": "DEV-2026-00008",
  "status": "refused",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/quote/Zp8w…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/quotes/5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z",
  "valid_until": "2026-11-14",
  "invoice_id": null
}

Transformer un devis en facture

post/companies/{company_id}/quotes/{quote_id}/convert

Émet une facture reprenant les lignes et le client du devis, qui passe invoiced. Le corps fixe la référence ERP et les dates de la facture.

Paramètres

company_idchemin · uuidobligatoire

Identifiant FACTURE de l'entreprise (client final du partenaire).

quote_idchemin · uuidobligatoire

Identifiant du devis.

Idempotency-Keyen-tête · texteobligatoire

Clé unique par opération (UUID conseillé), conservée 24 h. Renvoyer la même requête avec la même clé renvoie le même résultat sans rien créer de plus.

Corps de la requête · objet

external_reftexteobligatoire

Référence de la facture dans l'ERP.

issue_datedateobligatoire
due_datedatepeut être nul

Réponse · 201

La facture émise.

Erreurs possibles : 400401403404409422503

Requête
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/convert" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "ERP-FAC-2026-1203",
    "issue_date": "2026-10-25",
    "due_date": "2026-11-24"
  }'
Réponse 201
{
  "id": "8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d",
  "company_id": "3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "external_ref": "ERP-FAC-2026-1203",
  "number": "FAC-2026-00059",
  "status": "issued",
  "customer": {
    "id": "1b2c3d4e-5f60-4718-9a0b-1c2d3e4f5a6b",
    "external_ref": "ERP-TIERS-778",
    "name": "Aline Mbuyi",
    "company": "Studio Kivu",
    "email": "compta@studio-kivu.cd",
    "phone": "+243 811 111 111",
    "address": "12 avenue du Lac, Goma",
    "tax_id": "A7654321C"
  },
  "issue_date": "2026-10-14",
  "due_date": "2026-11-13",
  "currency": "USD",
  "order_number": "BC-2026-031",
  "notes": "Merci de rappeler le numéro de facture lors du paiement.",
  "lines": [
    {
      "description": "Audit des comptes annuels 2025",
      "quantity": "1",
      "unit_price": "1200.00",
      "total": "1200.00"
    },
    {
      "description": "Rapport de recommandations",
      "quantity": "2",
      "unit_price": "150.00",
      "total": "300.00"
    }
  ],
  "subtotal": "1500.00",
  "discount": "50.00",
  "shipping_amount": "0.00",
  "adjustment_amount": "0.00",
  "taxable_base": "1450.00",
  "vat_rate": "16",
  "vat_amount": "232.00",
  "total": "1682.00",
  "amount_paid": "0.00",
  "amount_credited": "0.00",
  "balance_due": "1682.00",
  "first_viewed_at": "2026-10-14T10:32:00Z",
  "last_viewed_at": "2026-10-16T08:05:00Z",
  "view_count": 2,
  "public_url": "https://gestion-hc-2026-0003.demo.dalaone.com/p/invoice/kQ3v…",
  "pdf_url": "/api/v1/companies/3f1c2b4a-5d6e-4f70-8a9b-0c1d2e3f4a5b/invoices/8a7b6c5d-4e3f-4a1b-9c8d-7e6f5a4b3c2d/pdf",
  "created_at": "2026-10-14T09:30:00Z",
  "updated_at": "2026-10-14T09:30:00Z"
}