Magento 2 Module pour Kiwiz - Documentation

Created by Jean-michel Arini
Last updated: Oct 01, 2020 by Sophie Rocco

Extension Kiwiz Pour Magento 2 - Version 1.0.4

1. Description

Depuis Janvier 2018, les sociétés ont l'obligation de certifier leurs transactions (factures et avoirs). Connue sous le nom "Loi anti fraude TVA 2018", la loi est applicable et des contrôles sont déjà en cours.

Kiwiz est une solution de certification des transactions, totalement autonome : nul besoin de changer votre système de facturation, Kiwiz se connecte à votre boutique en ligne et stocke vos données dans la BlockChain.

Magento, Prestashop, WooCommerce, Drupal... tous les CMS sont compatibles, même un CMS propriétaire en se connectant directement à l’API de KIWIZ.

https://www.kiwiz.io

2. Souscrire à une solution Kiwiz

https://www.kiwiz.io/prix

Une fois votre inscription effectuée, vous recevrez un email contenant vos identifiants Kiwiz à renseigner dans le module.

3. Compatibilité

  • Magento CE 2.3.x

  • PHP 7.1.3+ / 7.2.x / 7.3.x

4. Installation

IMPORTANT : Avant toute installation, faites une sauvegarde de la base de données et du répertoire web de votre site.

  1. Connectez-vous à votre site via SSH et accédez au dossier racine de Magento 2.

  2. Exécuter les commandes :

    1 2 3 4 composer require kwz/certification php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento setup:static-content:deploy

 

 

 

5. Utilisation de l’extension

5.1. Authentification

BOUTIQUES > Configuration > KIWIZ > Authentification

 

  • API url : Url de l’api Kiwiz, celle-ci est pré-remplie et ne doit pas être modifiée.

  • Nom d’utilisateur : Identifiant de connexion à l’API Kiwiz

  • Mot de passe : Mot de passe de connexion à l’API Kiwiz

  • ID de souscription : Identifiant de souscription à la solution Kiwiz

Une fois ces valeurs renseignées et enregistrées, Magento se connectera à l’API Kiwiz afin de récupérer les quotas d’utilisation.

 

Si votre Magento est configuré pour plusieurs boutiques, vous pourrez configurer des comptes Kiwiz différents pour chacune d’elles.

5.2. Configuration

BOUTIQUES > Configuration > KIWIZ > Configuration

5.2.1. Configuration générale

 

  • Activer les logs : Activer/désactiver l’enregistrement des informations d’utilisation et/ou d’échec dans des fichiers de logs.

  • Test mode : Activer/désactiver le mode test. Permet de configurer une boutique en mode test pour les essais ou la formation d’utilisateur. Les documents (factures et avoirs) et données envoyés en mode test sont enregistrés dans Kiwiz mais ne sont pas comptabilisés dans les clôtures.

Si vous passez en mode test une boutique en production, les documents (factures et avoirs) envoyés dans ce mode ne pourront plus être renvoyés en mode normal.

Vous pouvez passer du mode production à test ou de test à production autant de fois que vous le souhaitez pour vos besoins de formations ou de tests.

5.2.2. Configuration des attributs

 

  • Attribut correspondant à la valeur EAN du produit : Préciser l’attribut contenant l’information “EAN” du produit.

  • Attribut correspondant à la valeur fabriquant du produit : Préciser l’attribut contenant l’information “fabricant” du produit.

5.2.3. Alerte d'échec

Lorsqu'une requête à l’API Kiwiz échoue, un email est envoyé afin d’alerter de cet échec.

 

  • Activer : Activer/désactiver l’alerte.

  • Template d’email utilisé : Template de l’email utilisé pour cette alerte.

  • Destinataire de l’email : Adresse email du destinataire de l’alerte.

  • Nom du destinataire de l’email : Nom du destinataire de l’alerte.

5.2.4. Alerte de quota

Pour chaque seuil d’utilisation de l’API Kiwiz, un email est envoyé afin d’alerter son dépassement.

 

  • Activer : Activer/désactiver l’alerte.

  • Template d’email utilisé : Template de l’email utilisé pour cette alerte.

  • Quota d’utilisation pour l’alerte email : Seuils d’alerte d’utilisation de l’API Kiwiz séparé par des virgules.

  • Destinataire de l’email : Adresse email du destinataire de l’alerte.

  • Nom du destinataire de l’email : Nom du destinataire de l’alerte.

 

 

5.3 Envoi de documents (factures et avoirs)

5.3.1. Workflow

Les factures et les avoirs générés après l’activation du compte API Kiwiz sont automatiquement envoyés à Kiwiz lors de leurs créations dans Magento en temps réel.

 

L’API Kiwiz retourne à Magento l’empreinte du block ainsi que l’empreinte du fichier de facture ou d’avoir.
Ces informations permettent de retrouver le document dans la blockchain. Ces informations sont accessibles dans la commande ainsi que dans les grilles de factures et d’avoirs.

 

5.3.2. Statuts Kiwiz

Le statut Kiwiz représenté par des icônes informe de l'état de l’envoi des documents à Kiwiz, il est présent dans les factures, les avoirs et les commandes.

Ce statut peut prendre les valeurs suivantes :

OK

KO

WARNING

OK

KO

WARNING

  • Factures et avoirs : Le document a été envoyé sur Kiwiz avec succès.

  • Commandes : Tous les documents (factures et avoirs) de la commande ont été envoyés à Kiwiz avec succès.

  • Factures et avoirs : L’envoi du document à Kiwiz a échoué.

  • Commandes : L’envoi à Kiwiz d’au moins un document (facture ou avoir) de la commande a échoué.

  • Aucun document (facture ou avoir) à été généré pour le moment.

  • Factures et avoirs : Le document est ok mais ne peux pas être envoyé à Kiwiz car sa date d'édition est antérieure à l’activation du compte Kiwiz.

  • Commandes : Tous les documents (factures et avoirs) de la commande sont ok mais au moins un document de cette commande ne peut pas être envoyé à Kiwiz car sa date d'édition est antérieure à l’activation du compte Kiwiz.

Dans chaque grille (commandes, factures et avoirs) , il est possible de filtrer les éléments par ce statut.

 

5.3.3. Echec d’envoi

Lors de l’échec d’un envoi de document (facture ou avoir) à Kiwiz :

  • Un email d’alerte est envoyé si cette fonctionnalité a été activée.

  • Le document est placé dans une file d’attente et des nouvelles tentatives d’envois régulières sont faites tant que le document n’est pas reçu par Kiwiz.

Le nombre de tentatives et leurs messages d’erreur sont consultables dans la commande.

 

Il est également possible d’envoyer le document manuellement.

Certification d’une facture avec KIWIZ

 

Certification d’un avoir avec KIWIZ

 

 

6. Tutos vidéos