Intégration API KIWIZ

Created by Guillaume Sanchez
Last updated Jul 03, 2019

https://www.kiwiz.io/ est une plateforme de certification dans la Blockchain de documents (factures et avoirs).

Pour chaque facture et avoir, vous devez nous envoyer le document PDF et les données associées :

Documentation de l'API : https://api.kiwiz.io/doc#/

API : https://api.kiwiz.io/


Guide étapes par étapes :

Voici les étapes pour la mise en place

  1. Souscrire à un abonnement Kiwiz
  2. Récupérer son token d'identification
  3. Gestion des factures (post & get)
  4. Gestion des avoirs (post & get)


1 - Souscrire à un abonnement Kiwiz

Choisissez votre offre sur cette page : https://www.kiwiz.io/prix

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.

2 - Récupérer le token d'identification

Vous devez envoyer vos identifiants à l'API pour récupérer votre token.

Base URL API : https://api.kiwiz.io/

Documentation de l'API https://api.kiwiz.io/doc#/Tokens/authLogin

3 - Gestion des factures 

A : Envoyer les factures à l'API

Vous devez envoyer vos factures et données à l'API

Base URL API : https://api.kiwiz.io/

Documentation de l'API https://api.kiwiz.io/doc#/Factures/invoiceSave

  • Document : fichier PDF de la facture
  • Data : données de la facture

La liste des données à fournir se trouve directement dans la doc API dans la section :

  • Model : Invoice

L'api Kiwiz vous retournera le hash du fichier et le hash du block :

Le block hash vous servira pour faire vos "get".

B : Récupération des factures : 

Vous pouvez récupérer vos factures en interrogeant l'API Kiwiz avec votre "block_hash".

Documentation de l'API : https://api.kiwiz.io/doc#/Factures/invoiceGet

4 - Gestion des avoirs

A : Envoyer les avoirs à l'API

Vous devez envoyer vos factures et données à l'API

Base URL API : https://api.kiwiz.io/

Documentation de l'API https://api.kiwiz.io/doc#/Avoirs/creditmemoSave

  • Document : fichier PDF de l'avoir
  • Data : données de l'avoir

La liste des données à fournir se trouve directement dans la doc API dans la section :

  • Model : Creditmemo

L'api Kiwiz vous retournera le hash du fichier et le hash du block :

Le block hash vous servira pour faire vos "get".

B : Récupération des avoirs : 

Vous pouvez récupérer vos avoirs en interrogeant l'API Kiwiz avec votre "block_hash".

Documentation de l'API : https://api.kiwiz.io/doc#/Avoirs/creditmemoGet