Développeurs
API FACTURE
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.
https://gestion-hc-2026-0003.demo.dalaone.com/api/v1Vue 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}/pdfL'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}/payments5. Corriger une facture émise : jamais de modification, un avoir.
POST /companies/{id}/invoices/{invoice_id}/credit-notesDé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 modetest, 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 forbiddenavec 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 :
| Forfait | Accès |
|---|---|
| Starter | Pas d'API |
| Pro | Votre 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) |
| Business | Complet : 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êteIdempotency-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 :
| HTTP | code | Quand |
|---|---|---|
| 400 | invalid_request | JSON illisible, en-tête manquant |
| 401 | unauthorized | Clé absente, invalide ou révoquée |
| 403 | forbidden | Entreprise 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 |
| 404 | not_found | Élément introuvable |
| 409 | conflict | external_ref déjà utilisée, clé d'idempotence réutilisée autrement |
| 409 | document_locked | Action impossible sur ce document (facture annulée, devis déjà transformé…) |
| 422 | validation_error | Champ invalide ; le détail est dans details |
| 422 | amount_exceeds_balance | Paiement ou avoir supérieur au reste |
| 429 | rate_limited | Trop d'appels ; réessayer après Retry-After |
| 429 | limit_reached | Plafond mensuel de documents de votre contrat ou de votre forfait atteint |
| 500 | server_error | Erreur chez FACTURE ; réessayer avec la même Idempotency-Key |
| 503 | maintenance | Maintenance 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à :
429et un en-têteRetry-After. Les en-têtesX-RateLimit-Limit,X-RateLimit-RemainingetX-RateLimit-Resetindiquent 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_reachedjusqu'au mois suivant. - Les maintenances sont annoncées à l'avance ; pendant une maintenance, l'API répond
503 maintenanceavec 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
/companiesCré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 · texteobligatoireClé 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_reftexteobligatoireRéférence de l'entreprise dans l'ERP. Unique par partenaire.
nametexteobligatoireRaison sociale, telle qu'elle figure sur les documents.
emailtextepeut être nulE-mail de contact imprimé sur les documents.
phonetextepeut être nulTéléphone imprimé sur les documents.
addresstextepeut être nulAdresse du siège.
rccmtextepeut être nulRegistre du commerce et du crédit mobilier.
id_nattextepeut être nulIdentification nationale.
tax_numbertextepeut être nulNuméro d'impôt.
currencytexteobligatoireDevise par défaut (ISO 4217).
vat_ratetexteTaux de TVA par défaut, en pourcentage.
brandingobjetApparence des PDF. Le logo est copié chez FACTURE à l'enregistrement.
logo_urltextepeut être nulAdresse HTTPS d'une image PNG ou JPEG (5 Mo au plus).
brand_colortexteCouleur de marque.
header_colortexteCouleur d'en-tête.
invoice_templatetexteModèle de mise en page des factures et devis.
classiccleancompactsidebarcenteredletterheaddetailedreceiptthermalbilingualboldnumberingobjetNumérotation des documents. Les numéros sont attribués par FACTURE, sans trou.
invoice_prefixtextePréfixe des factures.
quote_prefixtextePréfixe des devis.
credit_prefixtextePréfixe des avoirs.
include_yearbooléenAjoute l'année (FAC-2026-00059) ; le compteur repart à 1 chaque 1er janvier.
document_textsobjetTextes imprimés en bas des documents.
payment_termstextepeut être nulConditions de paiement.
bank_detailstextepeut être nulCoordonnées bancaires.
legal_mentionstextepeut être nulMentions légales.
Réponse · 201
Entreprise créée.
Erreurs possibles : 400401409422429503
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
}
}'{
"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
/companiesLes entreprises créées par le partenaire.
Paramètres
external_refrequête · texteRetrouve l'élément par la référence de l'ERP.
updated_sincerequête · date-heureNe renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.
limitrequête · entierNombre d'éléments par page (1 à 100).
cursorrequête · texteCurseur renvoyé par la page précédente (`next_cursor`).
Réponse · 200
Une page d'entreprises (data : liste de Company).
Erreurs possibles : 401429503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}Paramètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Réponse · 200
L'entreprise.
Erreurs possibles : 401403404503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…" \
-H "Authorization: Bearer $API_KEY"{
"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
/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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Réponse · 204
Entreprise supprimée (réponse sans corps).
Erreurs possibles : 401403404503
curl -X DELETE "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…" \
-H "Authorization: Bearer $API_KEY"Modifier une entreprise
/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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Corps de la requête · CompanyUpdate
external_reftexteRéférence de l'entreprise dans l'ERP. Unique par partenaire.
nametexteRaison sociale, telle qu'elle figure sur les documents.
emailtextepeut être nulE-mail de contact imprimé sur les documents.
phonetextepeut être nulTéléphone imprimé sur les documents.
addresstextepeut être nulAdresse du siège.
rccmtextepeut être nulRegistre du commerce et du crédit mobilier.
id_nattextepeut être nulIdentification nationale.
tax_numbertextepeut être nulNuméro d'impôt.
currencytexteDevise par défaut (ISO 4217).
vat_ratetexteTaux de TVA par défaut, en pourcentage.
brandingobjetApparence des PDF. Le logo est copié chez FACTURE à l'enregistrement.
logo_urltextepeut être nulAdresse HTTPS d'une image PNG ou JPEG (5 Mo au plus).
brand_colortexteCouleur de marque.
header_colortexteCouleur d'en-tête.
invoice_templatetexteModèle de mise en page des factures et devis.
classiccleancompactsidebarcenteredletterheaddetailedreceiptthermalbilingualboldnumberingobjetNumérotation des documents. Les numéros sont attribués par FACTURE, sans trou.
invoice_prefixtextePréfixe des factures.
quote_prefixtextePréfixe des devis.
credit_prefixtextePréfixe des avoirs.
include_yearbooléenAjoute l'année (FAC-2026-00059) ; le compteur repart à 1 chaque 1er janvier.
document_textsobjetTextes imprimés en bas des documents.
payment_termstextepeut être nulConditions de paiement.
bank_detailstextepeut être nulCoordonnées bancaires.
legal_mentionstextepeut être nulMentions légales.
Réponse · 200
L'entreprise modifiée.
Erreurs possibles : 400401403404422503
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"
}
}'{
"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
/companies/{company_id}/invoicesCré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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Idempotency-Keyen-tête · texteobligatoireClé 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_reftexteobligatoireRéférence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).
customerCustomerInputobligatoireClient 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_reftexteobligatoireRéférence du client dans l'ERP. Unique par entreprise.
nametexteobligatoireNom du contact ou de la personne.
companytextepeut être nulRaison sociale (imprimée en premier si présente).
emailtextepeut être nulphonetextepeut être nuladdresstextepeut être nultax_idtextepeut être nulNuméro fiscal du client.
issue_datedateobligatoireDate d'émission (AAAA-MM-JJ).
currencytexteDevise ; par défaut celle de l'entreprise.
vat_ratetexteTaux de TVA en pourcentage ; par défaut celui de l'entreprise.
discountmontantRemise globale, hors taxes.
shipping_amountmontantFrais d'expédition, hors taxes.
adjustment_amountmontantAjustement hors taxes, positif ou négatif.
order_numbertextepeut être nulNuméro de commande du client.
notestextepeut être nulNote imprimée sur le document.
linesLineInput[]obligatoiredescriptiontexteobligatoireDésignation.
quantitytexteobligatoireQuantité, supérieure à 0 (trois décimales au plus).
unit_pricemontantobligatoirePrix unitaire hors taxes.
due_datedatepeut être nulDate d'échéance.
Réponse · 201
Facture émise.
Erreurs possibles : 400401403404409422429503
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"
}
]
}'{
"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
/companies/{company_id}/invoicesParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
statusrequête · texteFiltre par statut.
external_refrequête · texteRetrouve l'élément par la référence de l'ERP.
updated_sincerequête · date-heureNe renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.
limitrequête · entierNombre d'éléments par page (1 à 100).
cursorrequête · texteCurseur renvoyé par la page précédente (`next_cursor`).
Réponse · 200
Une page de factures (data : liste d'Invoice).
Erreurs possibles : 401403404429503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}/invoices/previewProduit 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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Corps de la requête · InvoicePreviewInput
external_reftexteRéférence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).
customerCustomerInputobligatoireClient 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_reftexteobligatoireRéférence du client dans l'ERP. Unique par entreprise.
nametexteobligatoireNom du contact ou de la personne.
companytextepeut être nulRaison sociale (imprimée en premier si présente).
emailtextepeut être nulphonetextepeut être nuladdresstextepeut être nultax_idtextepeut être nulNuméro fiscal du client.
issue_datedateobligatoireDate d'émission (AAAA-MM-JJ).
currencytexteDevise ; par défaut celle de l'entreprise.
vat_ratetexteTaux de TVA en pourcentage ; par défaut celui de l'entreprise.
discountmontantRemise globale, hors taxes.
shipping_amountmontantFrais d'expédition, hors taxes.
adjustment_amountmontantAjustement hors taxes, positif ou négatif.
order_numbertextepeut être nulNuméro de commande du client.
notestextepeut être nulNote imprimée sur le document.
linesLineInput[]obligatoiredescriptiontexteobligatoireDésignation.
quantitytexteobligatoireQuantité, supérieure à 0 (trois décimales au plus).
unit_pricemontantobligatoirePrix unitaire hors taxes.
due_datedatepeut être nulDate d'échéance.
Réponse · 200
Le PDF d'aperçu.
Erreurs possibles : 400401403404422429503
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.pdfLire une facture
/companies/{company_id}/invoices/{invoice_id}Paramètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
invoice_idchemin · uuidobligatoireIdentifiant de la facture.
Réponse · 200
La facture.
Erreurs possibles : 401403404503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}/invoices/{invoice_id}/pdfParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
invoice_idchemin · uuidobligatoireIdentifiant de la facture.
Réponse · 200
Le document PDF, au modèle de l'entreprise.
Erreurs possibles : 401403404503
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.pdfPaiements
Règlements signalés par l'ERP.
Enregistrer un paiement
/companies/{company_id}/invoices/{invoice_id}/paymentsSignale à 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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
invoice_idchemin · uuidobligatoireIdentifiant de la facture.
Idempotency-Keyen-tête · texteobligatoireClé 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_reftexteobligatoireRéférence du règlement dans l'ERP. Unique par entreprise.
amountmontantobligatoireMontant réglé, au plus égal au reste à payer.
paid_atdate-heureobligatoireDate et heure du règlement.
methodtexteobligatoireMoyen de paiement.
cashbank_transfercardmobile_moneychequeotherreferencetextepeut être nulRéférence bancaire ou de transaction.
Réponse · 201
Paiement enregistré.
Erreurs possibles : 400401403404409422429503
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"
}'{
"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
/companies/{company_id}/invoices/{invoice_id}/paymentsParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
invoice_idchemin · uuidobligatoireIdentifiant de la facture.
Réponse · 200
Les paiements (data : liste de Payment).
Erreurs possibles : 401403404503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/invoices/<invoice_id>/payments" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}/invoices/{invoice_id}/credit-notesSeule 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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
invoice_idchemin · uuidobligatoireIdentifiant de la facture.
Idempotency-Keyen-tête · texteobligatoireClé 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_reftexteobligatoireRéférence de l'avoir dans l'ERP. Unique par entreprise.
issue_datedateobligatoirereasontexteobligatoireMotif, imprimé sur l'avoir.
linesLineInput[]Lignes de l'avoir. Absentes : avoir total, qui reprend toute la facture et l'annule (cancelled).
descriptiontexteobligatoireDésignation.
quantitytexteobligatoireQuantité, supérieure à 0 (trois décimales au plus).
unit_pricemontantobligatoirePrix unitaire hors taxes.
Réponse · 201
Avoir émis.
Erreurs possibles : 400401403404409422429503
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"
}
]
}'{
"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
/companies/{company_id}/credit-notes/{credit_note_id}Paramètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
credit_note_idchemin · uuidobligatoireIdentifiant de l'avoir.
Réponse · 200
L'avoir.
Erreurs possibles : 401403404503
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"{
"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
/companies/{company_id}/credit-notes/{credit_note_id}/pdfParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
credit_note_idchemin · uuidobligatoireIdentifiant de l'avoir.
Réponse · 200
Le document PDF, au modèle de l'entreprise.
Erreurs possibles : 401403404503
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.pdfDevis
Émission, suivi et transformation en facture.
Émettre un devis
/companies/{company_id}/quotesCrée et émet le devis : numéro attribué par FACTURE, totaux calculés, PDF disponible.
Paramètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Idempotency-Keyen-tête · texteobligatoireClé 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_reftexteobligatoireRéférence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).
customerCustomerInputobligatoireClient 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_reftexteobligatoireRéférence du client dans l'ERP. Unique par entreprise.
nametexteobligatoireNom du contact ou de la personne.
companytextepeut être nulRaison sociale (imprimée en premier si présente).
emailtextepeut être nulphonetextepeut être nuladdresstextepeut être nultax_idtextepeut être nulNuméro fiscal du client.
issue_datedateobligatoireDate d'émission (AAAA-MM-JJ).
currencytexteDevise ; par défaut celle de l'entreprise.
vat_ratetexteTaux de TVA en pourcentage ; par défaut celui de l'entreprise.
discountmontantRemise globale, hors taxes.
shipping_amountmontantFrais d'expédition, hors taxes.
adjustment_amountmontantAjustement hors taxes, positif ou négatif.
order_numbertextepeut être nulNuméro de commande du client.
notestextepeut être nulNote imprimée sur le document.
linesLineInput[]obligatoiredescriptiontexteobligatoireDésignation.
quantitytexteobligatoireQuantité, supérieure à 0 (trois décimales au plus).
unit_pricemontantobligatoirePrix unitaire hors taxes.
valid_untildatepeut être nulDate de fin de validité de l'offre.
Réponse · 201
Devis émis.
Erreurs possibles : 400401403404409422429503
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"
}'{
"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
/companies/{company_id}/quotesParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
statusrequête · texteFiltre par statut.
external_refrequête · texteRetrouve l'élément par la référence de l'ERP.
updated_sincerequête · date-heureNe renvoie que les éléments modifiés depuis cette date (ISO 8601, UTC). Pour la synchronisation incrémentale.
limitrequête · entierNombre d'éléments par page (1 à 100).
cursorrequête · texteCurseur renvoyé par la page précédente (`next_cursor`).
Réponse · 200
Une page de devis (data : liste de Quote).
Erreurs possibles : 401403404429503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}/quotes/previewProduit 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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
Corps de la requête · QuotePreviewInput
external_reftexteRéférence du document dans l'ERP. Unique par entreprise : un deuxième envoi est refusé (conflict).
customerCustomerInputobligatoireClient 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_reftexteobligatoireRéférence du client dans l'ERP. Unique par entreprise.
nametexteobligatoireNom du contact ou de la personne.
companytextepeut être nulRaison sociale (imprimée en premier si présente).
emailtextepeut être nulphonetextepeut être nuladdresstextepeut être nultax_idtextepeut être nulNuméro fiscal du client.
issue_datedateobligatoireDate d'émission (AAAA-MM-JJ).
currencytexteDevise ; par défaut celle de l'entreprise.
vat_ratetexteTaux de TVA en pourcentage ; par défaut celui de l'entreprise.
discountmontantRemise globale, hors taxes.
shipping_amountmontantFrais d'expédition, hors taxes.
adjustment_amountmontantAjustement hors taxes, positif ou négatif.
order_numbertextepeut être nulNuméro de commande du client.
notestextepeut être nulNote imprimée sur le document.
linesLineInput[]obligatoiredescriptiontexteobligatoireDésignation.
quantitytexteobligatoireQuantité, supérieure à 0 (trois décimales au plus).
unit_pricemontantobligatoirePrix unitaire hors taxes.
valid_untildatepeut être nulDate de fin de validité de l'offre.
Réponse · 200
Le PDF d'aperçu.
Erreurs possibles : 400401403404422429503
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.pdfLire un devis
/companies/{company_id}/quotes/{quote_id}Paramètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
quote_idchemin · uuidobligatoireIdentifiant du devis.
Réponse · 200
Le devis.
Erreurs possibles : 401403404503
curl -X GET "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>" \
-H "Authorization: Bearer $API_KEY"{
"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
/companies/{company_id}/quotes/{quote_id}/pdfParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
quote_idchemin · uuidobligatoireIdentifiant du devis.
Réponse · 200
Le document PDF, au modèle de l'entreprise.
Erreurs possibles : 401403404503
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.pdfMarquer un devis accepté
/companies/{company_id}/quotes/{quote_id}/acceptParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
quote_idchemin · uuidobligatoireIdentifiant du devis.
Réponse · 200
Le devis, accepted.
Erreurs possibles : 401403404409503
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/accept" \
-H "Authorization: Bearer $API_KEY"{
"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é
/companies/{company_id}/quotes/{quote_id}/refuseParamètres
company_idchemin · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
quote_idchemin · uuidobligatoireIdentifiant du devis.
Réponse · 200
Le devis, refused.
Erreurs possibles : 401403404409503
curl -X POST "https://gestion-hc-2026-0003.demo.dalaone.com/api/v1/companies/3f1c2b4a-…/quotes/<quote_id>/refuse" \
-H "Authorization: Bearer $API_KEY"{
"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
/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 · uuidobligatoireIdentifiant FACTURE de l'entreprise (client final du partenaire).
quote_idchemin · uuidobligatoireIdentifiant du devis.
Idempotency-Keyen-tête · texteobligatoireClé 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_reftexteobligatoireRéférence de la facture dans l'ERP.
issue_datedateobligatoiredue_datedatepeut être nulRéponse · 201
La facture émise.
Erreurs possibles : 400401403404409422503
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"
}'{
"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"
}