Intégration API

Logiciel de facturation, solution e-commerce, CRM…
Vous utilisez votre propre plateforme pour générer des factures ?

Découvrez l'API Kiwiz, pour certifier les factures et avoirs sur votre plateforme.

Depuis janvier 2018, la loi des Finances 2016 (dite "loi anti-fraude à la TVA") impose l'utilisation d'une solution certifiée pour gérer votre facturation. Pour lutter contre la fraude à la TVA, l'Administration Fiscale a demandé aux nombreux professionnels concernés d'utiliser une solution réunissant différentes conditions :

Pour répondre à cette demande, nous avons créé Kiwiz qui permet la certification de vos documents (factures et avoirs) en temps réel dans la Blockchain.

Kiwiz est une solution API-centric, c’est-à-dire qu’elle fonctionne à partir d’une API, une interface de programmation applicative ouverte. Cela permet aux développeurs d’utiliser le « noyau » de Kiwiz pour toutes ces déclinaisons, dont les extensions.

Grâce à son API, Kiwiz s’intègre aussi très facilement dans votre plateforme, logiciel de facturation, CMS e-commerce… Ainsi votre solution est certifiée sans que vous ayez à vous en soucier.

Pour ce faire, vous avez besoin de créer un compte et de développer les fonctionnalités qui permettront d’envoyer et de récupérer les factures/avoirs.

Consulter la documentation API

Condition d'inaltérabilité : les données d’origine sont enregistrées, conservées, rendues inaltérables et garantie dans le temps.

Condition de sécurisation : les données d’origine sont sécurisées et la restitution des données de règlement dans l'état de leur enregistrement d'origine est assuré.

Condition de conservation : une clôture annuelle, mensuelle et journalière sont prévues et les données sont conservées, ligne par ligne, pendant 6 ans.

Condition d’archivage : les données sont figées et une date est attribuée aux documents archivés.

Comment intégrer Kiwiz via l’API ?

Pour faire certifier votre solution, vous devez nous envoyer chaque facture et avoir au format PDF avec les données associées. Nous récupérons les documents, les conservons, archivons et les certifions, vous avez juste à les récupérer pour les transmettre à vos clients.

Les étapes pour mettre en place Kiwiz en utilisant notre API :

Souscrire à un abonnement Kiwiz
Récupérer son token d'identification
Gérer les factures (les envoyer puis les récupérer)
Gérer les avoirs (idem)

Consulter le guide d'intégration Kiwiz

1. Souscrire à un abonnement Kiwiz

Choisissez votre offre sur cette page : https://www.kiwiz.io/prix (à savoir que chaque plan offre 30 jours d’essai gratuits).

Vous recevrez ensuite vos identifiants à l'API Kiwiz par email avec les éléments suivants :

username
password
subscription_id

Le subscription_id permet d'identifier votre système de caisse. Si vous avez plusieurs caisses, vous devez avoir plusieurs abonnements et donc plusieurs "subscription_id".

Si vous avez par exemple une boutique sous Magento en multi-boutique, vous devez avoir autant d'abonnements que de boutiques.

N'hésitez pas à nous contacter si vous avez des volumes importants.

2. Récupérer le token d’identification

Vous devez envoyer vos identifiants à l'API pour générer votre token d'identification, qui vous permettra d'envoyer et récupérer les factures/avoirs.

Voici un token d'exemple :

{ "token": "PQkd3574xgdSDGdgsf57gds37SDGsdg" }

Consulter la documentation sur la récupération de token

3. Gérer les factures

Envoyer les factures à l'API

Vous devez envoyer vos factures à l’API, les fichiers PDF et les données de facture.

Document : fichier PDF de la facture.
Data : données de la facture (voir la liste complète dans Models > Invoice).

Une fois tout cela envoyé, vous recevrez le hash du fichier et le hash du bloc, qui ressemblent à ça :

{

"file_hash": "PQkd3574xgdSDGdgsf5kihbfiudf5df7gds37SDGsdg",

"block_hash": "PQkd3574xgdSDlufhzuoh448ezr48f57gds37SDGsdg"

}

Le block hash vous permettra de récupérer les fichiers via la requête « get ».

Consulter la documentation sur l'envoi de factures

Récupérer les factures

Pour récupérer les factures certifiées, il faut interroger l’API Kiwiz avec le bloc « hash » reçu à l’étape précédente.

A savoir, la facture stockée dans Kiwiz est la seule originale certifiée, répondant à toutes les conditions. Pensez donc à bien la récupérer à chaque fois, comme lors de l’envoi de la facture par e-mail, la récupération de la facture dans le compte client ou dans le back-office…

Enfin, pour limiter les requêtes à l’API, pensez à stocker une copie de cette facture « get » dans votre système.

Consulter la documentation sur la récupération de factures

4. Gérer les avoirs

Envoyer les avoirs à l'API

De la même façon, il faut envoyer les avoirs à l’API sous 2 formes :

Document : fichier PDF de l’avoir.
Data : données de l’avoir (voir la liste complète dans Models > Creditmemo).

Vous recevrez un hash du fichier et un hash du block, qui vous servira pour la récupération.

Consulter la documentation sur l’envoi d’avoirs

Récupérer les avoirs

Pour récupérer les avoirs certifiés, il faut interroger l’API Kiwiz avec le « block_hash » récupéré avant.

De la même façon que pour les factures, le seul avoir certifié est celui stocké dans Kiwiz, pensez bien à le récupérer à chaque fois et à stocker une copie sur votre système.

Consulter la documentation sur la récupération d’avoirs

E-mails de clôtures (jour/mois/année)

L’administration fiscale oblige que le système de caisse qui enregistre les données de facturation mette en place un système de clôtures, tous les jours, mois et années. Chaque clôture doit être accompagnée de données récapitulatives inaltérables de la période.

Avec Kiwiz, pour chaque clôture, journalière, mensuelle ou annuelle, le titulaire du compte reçoit un e-mail avec :

Un récapitulatif des données (chiffre d’affaires, cumul HT, TTC…) ;
Le hash du block ;
Le hash du fichier ;
Un tableau de toutes les factures/avoirs au format CSV.

Cette fonctionnalité est gérée automatiquement par Kiwiz, du moment que vous remontez toutes les données de vos clients via l’API ils recevront bien ces e-mails de clôture.

Comment facturer Kiwiz aux utilisateurs de ma plateforme ?

Pour certifier votre plateforme, logiciel de facturation, CRM, CMS ou autre, nous avons mis en place un programme Revendeur. Vos clients restent vos clients, vous payez un compte multi-comptes et facturez vos clients comme bon vous semble.

Voici comment le programme Revendeur fonctionne :

Nous créons un compte Revendeur pour vous.
Vous créez un sous-compte à chacun de vos clients, avec le plan correspondant à leur volume de transactions (le plan s’adaptera si besoin).
Vous facturez la certification Kiwiz comme vous le souhaitez à vos clients.
Vous êtes facturé pour tous les comptes à un tarif préférentiel.

Il est ainsi plus simple d’intégrer la certification dans votre outil et c’est transparent pour vos clients.

Pour intégrer le programme Revendeur, consultez notre page Revendeurs et remplissez le formulaire.

Devenir Revendeur

Vous souhaitez avoir plus d'informations ?

CONTACTEZ-NOUS ICI