Documentation de l’API plateforme

Ce guide s’adresse aux développeurs d’une plateforme qui enregistre les entreprises de ses clients chez nous, envoie leurs factures et leurs avoirs à la normalisation par la DGI (la Direction générale des impôts de la République démocratique du Congo), et imprime elle-même les documents.

Comment ça marche, en bref

1. Vous enregistrez une entreprise (un de vos clients) avec son NIF. Vous enregistrez ses points de vente : chacun est un e-MCF, identifié par son NID, avec le jeton que la DGI lui a délivré.
2. Vous envoyez une facture ou un avoir pour cette entreprise. Nous répondons 202 tout de suite, avec la facture pending. Nous ne vous faisons jamais attendre la DGI.
3. La DGI normalise la facture en arrière-plan. Vous en apprenez le résultat par webhook, en lisant le flux d’événements, ou en lisant la facture.
4. Une facture normalisée porte tout ce qu’il faut pour que vous l’imprimiez vous-même : le code de la DGI, les données du QR code, les compteurs, les totaux, les lignes. Nous ne produisons aucun PDF pour vous.
5. Vous pouvez demander les rapports de la DGI (X, Z, A) en CSV ou en Excel, lire votre consommation, et récupérer un export complet d’une entreprise.

Par où commencer

• Démarrage rapide : de votre clé à votre première facture normalisée.
• Clés API et droits : authentifier vos appels et restreindre une clé.
• Flux d’événements et webhook : savoir ce qui s’est passé sur votre compte.
• Catalogue des erreurs : chaque code d’erreur, ce qu’il veut dire et que faire.
• Référence des routes et openapi.json : la liste des routes, lisible par une machine.

URL de base

• URL de base : https://api.getripa.com/api/platform/v1 (production) et https://api-dev.getripa.com/api/platform/v1 (test).